ImagerConversionDoc.tioga
Michael Plass, November 17, 1986 9:47:16 am PST
CONVERTING TO THE CEDAR 6.1 IMAGER
CEDAR X.X — FOR INTERNAL XEROX USE ONLY
Converting to the Cedar X.X Imager
Imager —> II
Michael Plass and Doug Wyatt
© Copyright 1986 Xerox Corporation. All rights reserved.
Abstract: The abstract goes here.
Created by: Package creator(s)
Maintained by: Package maintainer(s) <RName>
Keywords: keyword1, keyword2, ...
XEROX Xerox Corporation
Palo Alto Research Center
3333 Coyote Hill Road
Palo Alto, California 94304
For Internal Xerox Use Only
Notation
A —> B Trival conversion (usually just a rename)
A ~> B Slightly more complicated (parameters may be restructured)
A ~~~> B,C,D A has no direct replacement, but a similar function may be obtained by using B, C, and D in the right combination.
> ImagerXXX a newly introduced interface.
ImagerZZZ an old interface that has been removed.
> ImagerSample
This interface subsumes ImagerPixelMap, SampleMapOps
Vec: TYPE ~ RECORD [s, f: NAT]; "sSize, fSize: CARDINAL" ~> "size: Vec".
Box: TYPE ~ RECORD [min, size: Vec]; "start, size: CVEC" ~> "box: Box".
SampleMapOps.SampleMap ~> ImagerSample.SampleMap
SampleMapOps.CVEC ~> SF.Vec
SampleMapOps.ComputeWords ~> ImagerSample.WordsForMap
SampleMapOps.UnsafeCreate ~> ImagerSample.UnsafeNewMap
SampleMapOps.Create ~> ImagerSample.NewMap
SampleMapOps.FromVM ~> ImagerSample.MapFromVM
SampleMapOps.FromSubMap —> ImagerSample.MapFromSubMap
SampleMapOps.Copy —> ImagerSample.CopyMap
SampleMapOps.ObtainScratch ~> ImagerSample.ObtainScratchMap
SampleMapOps.ReleaseScratch —> ImagerSample.ReleaseScratchMap
SampleMapOps.DoWithScratch ~> ImagerSample.DoWithScratchMap
SampleMapOps.Size —> (access size field of record)
SampleMapOps.TileBox ~> ImagerSample.Tile
SampleMapOps.BoxProc ~~~> use ImagerSample.BoxBuffer
SampleMapOps.GetSample ~> ImagerSample.Get
SampleMapOps.PutSample ~> ImagerSample.Put
SampleMapOps.Get ~> ImagerSample.GetSamples
SampleMapOps.Put ~> ImagerSample.PutSamples
> ImagerPixel
This interface subsumes the old ImagerSample; data structures for multi-sample per pixel buffers and arrays, and sampling operations for them.
ImagerTransformation
Added ScanMode, SFToXY, XYToSF, ApplyInvert
ImagerFont
Typeface type now defined here. Font is just an atom-like REF. Added FindScaled.
width —> escapement
ImagerColorDefs
These type definitions are now in ImagerColor.
ImagerPixelArrayDefs
These type definitions are now in ImagerPixelArray.
ImagerColorOperator
Merged into ImagerColor. The structure of the color operator machinery has changed.
ImagerExtras
Merged into Imager. NewStrokeEnd —> Imager.StrokeEnd, etc.
ImagerColor
The Color type is restructured.
The structure of the color operator machinery has changed.
Imager
Added FindFontScaled.
MaskBits ~> MaskBitmap (now takes a SampleMap argument).
Added FindFontScaled.
Revised StrokeEnd type.
Added MaskDashedStroke, MaskDashedStrokeTrajectory
The "parity" parameter on the MaskFill* and Clip* procs have been renamed to "oddWrap"
ImagerBackdoor
ImagerBackdoor.GetBounds -> ImagerBackdoor.GetBoundingRectangle
ImagerBackdoor.Bitmap ~> IISample.SampleMap
ImagerBackdoor.NewBitmap ~> IISample.NewSampleMap
DrawBits now takes a SampleMap argument.
tx, ty ~> REAL?
BitmapContext now takes a SampleMap argument.
DrawPixels
Coordinate system stuff
DoWithBuffer
ImagerOps
The ImagerOps interface is discontinued. Its functionality is available elsewhere.
PixelArrayFromPixelMaps ~~~> ImagerPixelArray.FromPixelMap, ImagerPixel.MakePixelMap
PixelMapFromPixelArray ~~~> ImagerSample.CreateMap, ImagerPixelArray.Transfer
PixelMapFromFrameBuffer ~> ImagerSample.MapFromFrameBuffer
SurfaceToDevice ~> ImagerBackdoor.mumble
DoWithBuffer ~> ImagerBackdoor.DoWithBuffer
ContextFromPixelMaps: removed (was never implemented)
ImagerColorMap
No changes
ImagerTerminal
No changes
ImagerTypeface
width —> escapement
ImagerPrivate
MaskBitmap, DrawBitmap take SampleMap arguments
DoWithBuffer
Context transform stuff
ImagerDevice
MaskBits, DrawBits take SampleMap (tx, ty: INTEGER ~> tx, ty: REAL)
DoWithBuffer
Context transform stuff
ImagerManhattan
DeviceRectangle ~> Box
ImagerManhattanExtras
Merged into ImagerManhattan.
ImagerDevice
MaskRuns subsumed by MaskBoxes.
MaskBits, DrawBits take SampleMap
HalftoneParameters gone.
Class —> DeviceClass
.MoveBoxes ~> .MoveBox
IIScanConverter
Runs converted to Boxes.
ConvertToPixels removed.
IIScanConverterPrivate
No changes.
IIMask
Need the BoxesFromBitmap functionality somewhere (IISample?). Some changes to char mask rep may obviate need for RunsFromCharMask.