All,
I feel we should work on something real when discussing the UPDF spec, the
sections we implement, other printer descriptions used as a base and the
defintion of subgroups.
I hope the attached four ASCII files (Windows International char set) are
helpful showing the differences we have to deal with and ways to go.
These are two descriptions (Paper source and Power save), each provided one
general and once filled with parameters.
I did not care about syntax.
I did not care about a real structure.
I did not care about completeness or perfect correctness.
My major concern was to start a discussion about an open structure (you can
add proprietary sections and/or delete optional sections without injuring
the format).
Some details are that the short cuts are not included in the string (like an
ampercent) to ease translations or to rank elements of a module per language
to provide an easy fallback mechanism for defaults.
Xionics will be participating with some people in tomorrow's teleconference.
We may refer to these documents.
If I am not clear enough in some areas, please ask me directly for further
explanations.
Regards
Norbert
-------------- next part --------------
Legend
ModuleClassifications
M_ // mandatory, predefined by UPDF
// must be supported
O_ // optional, predefined by UPDF
// can be supported
P_ // optional, proprietary, defined by manufacturer
// can be supported
ParameterClassifications
G_ // global, predefined by UPDF
// the first 500 reserved
P_ // proprietary, defined by manufacturer
// the second 500 reserved
U_ // user defined
// the third 500 reserved
This module is called ID_PaperSource with all the available input trays as elements.
Some descriptions are general for the module. Later you see those descriptions specific to each element of the module.
The general descriptions of this module are:
M_Basics
O_Comment
M_PrinterConnector
O_OwnsElements
O_ElementsPaperSource
M_Dialog
M_Style
M_Attributes
M_Margins
M_Left
M_Right
M_Top
M_Bottom
M_StoreData
M_MemberOfSet
M_MemberOfGroup
M_RelatedToElement
M_Position // relative to M_RelatedToElement
M_Horizontal
M_Vertical
M_ElementTitle
M_Style
M_Margins
M_Left
M_Right
M_Top
M_Bottom
M_Attributes
M_Position
M_Horizontal
M_Vertical
M_Language // per Language
O_BalloonHelp // per Language
O_Help
O_CheckRelatedElementSizes
O_Preview
O_ElementImage
FunctionCall
M_Functions
Init
CallBack1
O_Communication
O_Errors
O_Event
O_Message // per Language
O_Config
O_JobStatus
These are the element specific descriptions:
O_ElementsPaperSource
M_ElementBasics
O_ElementComment // per Element
M_TechnicalElementID // per Element
M_ValueLimitations
M_MinimumWidth // per Element unit: mm/10
M_MaximumWidth // per Element unit: mm/10
M_MinimumLength // per Element unit: mm/10
M_MaximumLength // per Element unit: mm/10
O_LeftOffset // per Element unit: mm/10
O_RightOffset // per Element unit: mm/10
M_Ranking // per Language
M_ElementLanguage // per Element per Language
O_Preview
O_PaperPathPreview
FunctionCall
sample parameters:
FeedingAngle
FrontPage
O_PrinterConfigPreview
FunctionCall
sample parameters:
ImageSelected
ImageDeselected
M_Print
O_SequenceJobHeader
O_Ranking
O_Redundancy
O_SequenceJobTrailer
O_Ranking
O_Redundancy
O_SequenceJobStart // after JobHeader
O_Ranking
O_Redundancy
O_SequenceJobEnd // before JobEnd
O_Ranking
O_Redundancy
O_SequencePageStart
O_Ranking
O_Redundancy
O_SequencePageEnd
O_Ranking
O_Redundancy
O_Filters
O_ActiveFilters
sample parameters:
FeedingAngle, ID_PaperSize, ID_HWMargins // combined filter
O_Condition
O_Message // per Language
ID_PrintMedia
O_Condition
O_Message // per Language
ID_Duplex
O_Condition
O_Message // per Language
O_PassiveFilters
sample parameters:
ID_InputOptions
O_Message
O_Communication
O_Errors
O_Event
O_Message // per Language
O_Config
-------------- next part --------------
ID_PaperSource
Sample for 2 human languages (US English, German), 2 elements (Tray 1, Manual)
M_Basics
O_Comment Paper sources of model Sirius
M_PrinterConnector Connected to the lower connector, the same connector is provided at its
bottom for other paper sources
O_OwnsElements
O_ElementsPaperSource
M_Dialog
M_Style Combo box with max 5 entries at a time
M_Attributes Change to static text control, if 1 entry
M_Margins // around the combo box
M_Left 5 pixel
M_Right 5 pixel
M_Top 5 pixel
M_Bottom 5 pixel
M_StoreData dmDefaultSource
M_MemberOfSet QuickSets
M_MemberOfGroup TabGroup_Paper
M_RelatedToElement ID_PaperSize
M_Position
M_Horizontal Same
M_Vertical Down
O_CheckRelatedElementSizes ID_PaperSize
M_ElementTitle
M_Style StaticText
M_Margins // around the text prompt
M_Left 5 pixel
M_Right 5 pixel
M_Top 5 pixel
M_Bottom 5 pixel
M_Attributes Short cut
M_Position
M_Horizontal Left
M_Vertical Same
M_Language US English: Paper Source (7),
German: Papierschacht (7)
// the bracket shows the short cut position within the string
O_BalloonHelp US English: Select a paper source.
German: Waehlen Sie einen Schacht aus.
O_Help HLP_PaperSource // entry point for the help fle
O_CheckRelatedElementSizes ID_PaperSize
/* This dialog section says that paper source is to be shown within the Paper tab below the paper size control, not smaller than the paper size control.
Paper source is to be provided as a combo box with the prompt left to it, no small picture next to the control. A margin of 5 pixel shall be used around the combo box as well as around the text. */
M_Functions
Init use standard initialization
O_ElementsPaperSource
M_ElementBasics
O_ElementComment Tray 1 of Sirius
M_TechnicalElementID Input1 // predefined
M_ValueLimitations
M_MinimumWidth 1000 unit: mm/10
M_MaximumWidth 2159 unit: mm/10
M_MinimumLength 1000 unit: mm/10
M_MaximumLength 3556 unit: mm/10
M_Ranking US English: 1
German: 2
M_ElementLanguage US English: Tray 1
German: Schacht 1
O_Preview
O_PaperPathPreview
FunctionCall
sample parameters:
FeedingAngle the feeding angle for the selected paper size
FrontPage Face down
O_PrinterConfigPreview
FunctionCall
sample parameters:
ImageSelected BMP_Highlight_Tray1
ImageDeselected BMP_Tray1
M_Print
O_SequencePageStart esc & l 1 H
O_Ranking as second command sequence at page start
O_Redundancy only to be sent, if different
O_SequencePageEnd FormFeed
O_Ranking as first command sequence at page end
O_Redundancy Sent always
O_Filters
O_ActiveFilters
FeedingAngle, ID_PaperSize, ID_HWMargins List
O_Condition Short-edge, Letter, each min margin = 75
Short-edge, A4, each min margin = 71
O_PassiveFilters // passive filters are acceleration fields
ID_InputOptions List // automatically filled by definition of active filters
//of ID_InputOptions
M_ElementBasics
O_ElementComment Manual Tray of Sirius
M_TechnicalElementID Manual // predefined
M_ValueLimitations
M_MinimumWidth 1000 unit: mm/10
M_MaximumWidth 2970 unit: mm/10
M_MinimumLength 1000 unit: mm/10
M_MaximumLength 4200 unit: mm/10
M_Ranking US English: 2
German: 1
M_ElementLanguage US English: Manual
German: Manuell
O_Preview
O_PaperPathPreview
FunctionCall
sample parameters:
FeedingAngle the feeding angle for the selected paper size
FrontPage Face down
O_PrinterConfigPreview
FunctionCall
sample parameters:
ImageSelected BMP_Highlight_Manual
ImageDeselected BMP_Manual
M_Print
O_SequencePageStart esc & l 2 H
O_Ranking as second command sequence at page start
O_Redundancy only to be sent, if different
O_SequencePageEnd FormFeed
O_Ranking as first command sequence at page end
O_Redundancy Sent always
O_Filters
O_ActiveFilters
FeedingAngle, ID_PaperSize, ID_HWMargins List
O_Condition Long-edge, Letter, each min margin = 75
Long-edge, A4, each min margin = 71
Short-edge, A3, each margin = 71
O_PassiveFilters // passive filters are acceleration fields
ID_InputOptions List // automatically filled by definition of active filters
//of ID_InputOptions
-------------- next part --------------
Legend
ModuleClassifications
M_ // mandatory, predefined by UPDF
// must be supported
O_ // optional, predefined by UPDF
// can be supported
P_ // optional, proprietary, defined by manufacturer
// can be supported
ParameterClassifications
G_ // global, predefined by UPDF
// the first 500 reserved
P_ // proprietary, defined by manufacturer
// the second 500 reserved
U_ // user defined
// the third 500 reserved
This module is called ID_PowerSave just with 2 settings as elements.
Some descriptions are general for the module. Later you see those descriptions specific to each element of the module.
The general descriptions of this module are:
M_Basics
O_Comment
O_OwnsElements
O_ElementsPowerSave
M_Dialog
M_Style
M_Attributes
M_Margins
M_Left
M_Right
M_Top
M_Bottom
M_StoreData
M_MemberOfSet
M_MemberOfGroup
M_RelatedToElement
M_Position // relative to M_RelatedToElement
M_Horizontal
M_Vertical
M_ElementTitle
M_Style
M_Margins
M_Left
M_Right
M_Top
M_Bottom
M_Attributes
M_Position
M_Horizontal
M_Vertical
M_Language // per Language
O_BalloonHelp // per Language
O_Help
O_CheckRelatedElementSizes
O_Preview
O_ElementImage
FunctionCall
M_Functions
Init
CallBack1
O_Communication
O_Errors
O_Event
O_Message // per Language
O_Config
O_JobStatus
These are the element specific descriptions:
O_ElementsPowerSave
M_ElementBasics
O_ElementComment // per Element
M_TechnicalElementID // per Element
M_Ranking // per Language
M_ElementLanguage // per Element per Language
M_Print
O_SequenceJobHeader
O_Ranking
O_Redundancy
O_SequenceJobTrailer
O_Ranking
O_Redundancy
O_Filters
O_ActiveFilters
O_PassiveFilters
sample parameters:
ID_Model
O_Message
O_Communication
O_Errors
O_Event
O_Message // per Language
O_Config
-------------- next part --------------
ID_PowerSave
Sample for 2 human languages (US English, German), 2 elements (On, Off)
M_Basics
O_Comment Power save modes of model Sirius
O_OwnsElements
O_ElementsPowerSave
M_Dialog
M_Style Combo box with max 2 entries at a time
M_Attributes Change to static text control, if 1 entry
M_Margins // around the combo box
M_Left 5 pixel
M_Right 5 pixel
M_Top 5 pixel
M_Bottom 5 pixel
M_StoreData XDMPowerSave
M_MemberOfSet QuickSets
M_MemberOfGroup TabGroup_PermanentSettings
M_RelatedToElement zero // This is the first element in the group
M_Position
M_Horizontal Left
M_Vertical Top
O_CheckRelatedElementSizes zero // ignore all other controls in this dialog for the size
// of this control
M_ElementTitle
M_Style StaticText
M_Margins // around the text prompt
M_Left 5 pixel
M_Right 5 pixel
M_Top 5 pixel
M_Bottom 5 pixel
M_Attributes Short cut
M_Position
M_Horizontal Left
M_Vertical Same
M_Language US English: Power Save (1),
German: Sparmodus (2)
// the bracket shows the short cut position within the string
O_BalloonHelp US English: Select the power save mode.
German: Waehlen Sie den Sparmodus.
O_Help HLP_PowerSave // entry point for the help fle
O_CheckRelatedElementSizes zero
O_Preview
O_ElementImage BMP_PLUG
FunctionCall
/* This dialog section says that power save is to be shown within the Permanent settings tab at the upper left corner.
Power save is to be provided as a combo box with the prompt left to it, a small picture of a plug next to the control. A margin of 5 pixel shall be used around the combo box as well as around the text. */
M_Functions
Init use standard initialization
O_ElementsPowerSave
M_ElementBasics
O_ElementComment Power save on
M_TechnicalElementID ON // predefined
M_Ranking US English: 1
German: 2
M_ElementLanguage US English: On
German: An
M_Print
O_SequenceJobHeader @PJL SET POWERSAVE=ON
O_Ranking as third command sequence in job header
O_Redundancy sent always
O_Filters
O_PassiveFilters // passive filters are acceleration fields
ID_Model List // automatically filled by definition of active filters
//of ID_Model
M_ElementBasics
O_ElementComment Power save off
M_TechnicalElementID OFF // predefined
M_Ranking US English: 1
German: 2
M_ElementLanguage US English: Off
German: Aus
M_Print
O_SequenceJobHeader @PJL SET POWERSAVE=OFF
O_Ranking as third command sequence in job header
O_Redundancy sent always
O_Filters
O_PassiveFilters // passive filters are acceleration fields
ID_InputOptions List // automatically filled by definition of active filters
//of ID_InputOptions