|
AIDocumentViewSuite Struct Reference
[API Suite List]
Use these functions to get and set properties of a document view, including the bounds, center, zoom, and screen mode.
More...
#include <AIDocumentView.h>
List of all members.
Public Attributes |
AIAPI AIErr(* | GetDocumentViewBounds )(AIDocumentViewHandle view, AIRealRect *bounds) |
| Retrieves the bounds of a document view in artwork coordinates (that is, the portion of the artboard that is visible in the window).
|
AIAPI AIErr(* | GetDocumentViewCenter )(AIDocumentViewHandle view, AIRealPoint *center) |
| Retrieves the center of a document view in artwork coordinates (that is, the point of the artboard that maps to the center of the window).
|
AIAPI AIErr(* | SetDocumentViewCenter )(AIDocumentViewHandle view, const AIRealPoint *center) |
| Sets the point of the artboard that maps to the center of the window for a view.
|
AIAPI AIErr(* | GetDocumentViewZoom )(AIDocumentViewHandle view, AIReal *zoom) |
| Retrieves the zoom factor for a view.
|
AIAPI AIErr(* | SetDocumentViewZoom )(AIDocumentViewHandle view, AIReal zoom) |
| Sets the scale factor from artwork coordinates to window coordinates for a view.
|
AIAPI AIErr(* | ArtworkPointToViewPoint )(AIDocumentViewHandle view, const AIRealPoint *artworkPoint, AIPoint *viewPoint) |
| Converts a point from artwork coordinates to view (window) coordinates.
|
AIAPI AIErr(* | ViewPointToArtworkPoint )(AIDocumentViewHandle view, const AIPoint *viewPoint, AIRealPoint *artworkPoint) |
| Converts a point from view coordinates to artwork coordinates.
|
AIAPI AIErr(* | CountDocumentViews )(ai::int32 *count) |
| Gets the number of open views for the current document.
|
AIAPI AIErr(* | GetNthDocumentView )(ai::int32 n, AIDocumentViewHandle *view) |
| Retrieves a document view for the current document by position index.
|
AIAPI AIErr(* | FixedArtworkPointToViewPoint )(AIDocumentViewHandle view, const AIRealPoint *artworkPoint, AIRealPoint *viewPoint) |
| Converts a point from artwork coordinates to view (window) coordinates.
|
AIAPI AIErr(* | FixedViewPointToArtworkPoint )(AIDocumentViewHandle view, const AIRealPoint *viewPoint, AIRealPoint *artworkPoint) |
| Converts a point from view coordinates to artwork coordinates.
|
AIAPI AIErr(* | SetScreenMode )(AIDocumentViewHandle view, AIScreenMode mode) |
| Sets the screen mode of a view.
|
AIAPI AIErr(* | GetScreenMode )(AIDocumentViewHandle view, AIScreenMode *mode) |
| Retrieves the screen mode of a view.
|
AIAPI AIErr(* | GetPageTiling )(AIPageTiling *pageTiling) |
| Retrieves the page tiling information that describes how the artwork is printed onto one or more pages.
|
AIAPI AIErr(* | GetTemplateVisible )(AIDocumentViewHandle view, AIBoolean *visible) |
| Reports whether there is a visible template layer.
|
AIAPI AIErr(* | DocumentViewScrollDelta )(AIDocumentViewHandle view, AIRealPoint *delta) |
| Scrolls a document window.
|
AIAPI AIErr(* | GetDocumentViewInvalidRect )(AIDocumentViewHandle view, AIRealRect *invalidRect) |
| Retrieves a rectangle that encloses (at least) the portions of the viewed document that have been changed and so need to be redrawn.
|
AIAPI AIErr(* | SetDocumentViewInvalidRect )(AIDocumentViewHandle view, const AIRealRect *invalidRect) |
| Sets the invalid rectangle for a view.
|
AIAPI AIErr(* | GetDocumentViewStyle )(AIDocumentViewHandle view, ai::int16 *style) |
| Retrieves the display mode for a view.
|
AIAPI AIErr(* | SetDocumentViewInvalidDocumentRect )(AIDocumentViewHandle view, const AIRealRect *invalidRect) |
| Sets the invalid rectangle for all views of a viewed document.
|
AIAPI AIErr(* | GetShowPageTiling )(AIBoolean *show) |
| Reports whether page tiling is shown for the current view.
|
AIAPI AIErr(* | SetShowPageTiling )(AIBoolean show) |
| Sets the page tiling mode for the current view.
|
AIAPI AIErr(* | GetGridOptions )(AIDocumentViewHandle view, AIBoolean *show, AIBoolean *snap) |
| Retrieves grid options for a view.
|
AIAPI AIErr(* | SetGridOptions )(AIDocumentViewHandle view, AIBoolean show, AIBoolean snap) |
| Sets grid options for a view.
|
AIAPI AIErr(* | GetShowTransparencyGrid )(AIDocumentViewHandle view, AIBoolean *show) |
| Reports whether the transparency grid is shown in a view.
|
AIAPI AIErr(* | SetShowTransparencyGrid )(AIDocumentViewHandle view, AIBoolean show) |
| Sets whether the transparency grid is shown in the view.
|
AIAPI AIErr(* | GetDocumentViewDocument )(AIDocumentViewHandle view, AIDocumentHandle *document) |
| Retrieves the document displayed in a view.
|
AIAPI AIErr(* | ForceDocumentViewsOnScreen )(void) |
| Forces all document views to not be obscured by the Control palette.
|
AIAPI AIErr(* | GetShowGuides )(AIDocumentViewHandle view, AIBoolean *show) |
| Retrieves the visibility state of the guides.
|
AIAPI AIErr(* | SetShowGuides )(AIDocumentViewHandle view, AIBoolean show) |
| Sets the visibility state of the guides.
|
AIAPI AIErr(* | GetShowEdges )(AIDocumentViewHandle view, AIBoolean *show) |
| Retrieves the visibility state of the edges of the selection.
|
AIAPI AIErr(* | SetShowEdges )(AIDocumentViewHandle view, AIBoolean show) |
| Sets the visibility state of the edges of the selection.
|
AIAPI AIErr(* | SaveImage )(AIDocumentViewHandle view, const ai::UnicodeString &saveFilename, const AIPoint &windowSize) |
| Captures the contents of the view window (excluding scrollbars, etc.
|
AIAPI AIErr(* | IsArtboardRulerVisible )(const AIDocumentViewHandle view, AIBoolean *visible) |
| Determines the current state of video rulers if they are visible or not.
|
AIAPI AIErr(* | SetArtboardRulerVisible )(const AIDocumentViewHandle view, const AIBoolean visible) |
| Sets the video rulers visibility on or off.
|
AIAPI AIErr(* | CountOPPPlates )(AIDocumentViewHandle view, ai::int32 &count) |
| Returns the number plates in the plate set for the view.
|
AIAPI AIErr(* | GetNthOPPPlate )(AIDocumentViewHandle view, ai::int32 n, ai::ColorSpace &plate) |
| Get an identifier for the nth plate in the view's plate set.
|
AIAPI AIErr(* | GetOPPPlateState )(AIDocumentViewHandle view, const ai::ColorSpace &plate, AIBoolean &isOn) |
| Get the visibility state for plate in the current view's plate state.
|
AIAPI AIErr(* | SetOPPPlateState )(AIDocumentViewHandle view, const ai::ColorSpace &plate, const AIBoolean isOn) |
| Set the visibility state for plate in the current view's plate state.
|
AIAPI AIErr(* | SetDocumentViewStyle )(AIDocumentViewHandle view, ai::int16 style, ai::int16 mask) |
| Sets the display mode for a view.
|
AIAPI AIErr(* | IsRulerInArtboardCoordinates )(const AIDocumentViewHandle view, ASBoolean *isYes) |
| Determines whether the rulers are shown in Artboard co-ordinates.
|
AIAPI AIErr(* | UseArtboardCoordinatesInRuler )(const AIDocumentViewHandle view, const ASBoolean state) |
| Sets the rulers to use Artboard co-ordinates.
|
AIAPI AIBoolean(* | IsGPUPreviewModeOn )(const AIDocumentViewHandle view) |
| Returns whether GPU Preview mode is enabled for the view.
|
AIAPI AIErr(* | GetGPUPixel )(AIWindowRef window, AIPoint location, AIColor &color) |
| Returns color value of location inside document window.
|
AIAPI AIErr(* | GetDocumentViewVisibleArea )(AIDocumentViewHandle view, AIRealRect *bounds) |
| Returns the bounds of the area visible to the user, ie after excluding the area covered by ruler and isolation mode UI.
|
Detailed Description
Use these functions to get and set properties of a document view, including the bounds, center, zoom, and screen mode.
To operate on the current view, you can usually pass NULL for the view parameter. To get a view reference for the current view, pass 0 to AIDocumentViewSuite::GetNthDocumentView() .
Member Data Documentation
Converts a point from artwork coordinates to view (window) coordinates.
The resulting view coordinate is rounded to the nearest pixel.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| artworkPoint | The point to convert, in artwork coordinates. |
| viewPoint | [out] A buffer in which to return the converted point, in window coordinates. |
- See also:
FixedArtworkPointToViewPoint() (does not round)
Gets the number of open views for the current document.
Use with GetNthDocumentView() to iterate through views.
- Parameters:
-
| count | [out] A buffer in which to return the number of views. |
Returns the number plates in the plate set for the view.
The plate set is only relevant for OPP view mode.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| count | [out] The number of plates. |
Scrolls a document window.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| delta | The vector by which to scroll, a horizontal and vertical distance in points. |
Converts a point from artwork coordinates to view (window) coordinates.
Does not round the result.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| artworkPoint | The point to convert, in artwork coordinates. |
| viewPoint | [out] A buffer in which to return the converted point, in window coordinates. |
- See also:
ArtworkPointToViewPoint() (rounds result to nearest pixel)
Converts a point from view coordinates to artwork coordinates.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| viewPoint | The point to convert, in window floating-point coordinates. |
| artworkPoint | [out] A buffer in which to return the converted point, in artboard coordinates. |
- See also:
ViewPointToArtworkPoint() (takes pixel coordinate values)
Forces all document views to not be obscured by the Control palette.
Retrieves the bounds of a document view in artwork coordinates (that is, the portion of the artboard that is visible in the window).
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| bounds | [out] A buffer in which to return the bounding box. |
Retrieves the center of a document view in artwork coordinates (that is, the point of the artboard that maps to the center of the window).
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| center | [out] A buffer in which to return the center point. |
Retrieves the document displayed in a view.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| document | [out] A buffer in which to return the document reference. |
Retrieves a rectangle that encloses (at least) the portions of the viewed document that have been changed and so need to be redrawn.
This rectangle is reset to be empty each time the kAIDocumentViewInvalidRectChangedNotifier is sent.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| invalidRect | [out] A buffer in which to return the invalid area, in artwork coordinates. |
Retrieves the display mode for a view.
- Parameters:
-
Returns the bounds of the area visible to the user, ie after excluding the area covered by ruler and isolation mode UI.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| bounds | [out] A buffer in which to return the bounding box. |
Retrieves the zoom factor for a view.
This is the scale factor from artwork coordinates to window coordinates.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| zoom | [out] A buffer in which to return the zoom factor, a percentage value where 1 is 100% (actual size), 0.5 is 50% and 2 is 200%. |
Returns color value of location inside document window.
If location or window does not correspond to any document window of AI which is in GPU preview mode, bad parameter error is returned Only implemented for windows platform.
Retrieves grid options for a view.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| show | [out] A buffer in which to return true if the grid is visible. |
| snap | [out] A buffer in which to return true if the snap-to-grid is on. |
Retrieves a document view for the current document by position index.
Use with CountDocumentViews() to iterate through views.
- Parameters:
-
| n | The index, in the range [1..numViews] , or 0 to get the current view. |
| view | [out] A buffer in which to return the view reference. |
Get an identifier for the nth plate in the view's plate set.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| plate | [out] The plate identifier. |
Get the visibility state for plate in the current view's plate state.
Visibility is only recognized for OPP view mode.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| plate | Identifier for the plate to get the state of. |
| isOn | [out] The current visibility state of plate . |
Retrieves the page tiling information that describes how the artwork is printed onto one or more pages.
- Parameters:
-
| pageTiling | [out] A buffer in which to return the tiling information. |
Retrieves the screen mode of a view.
In the UI, the screen mode is shown by icons at the bottom of the Tool palette.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| mode | [out] A buffer in which to return the screen mode. |
Retrieves the visibility state of the edges of the selection.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| show | True to make the edges visible, false to hide them. |
Retrieves the visibility state of the guides.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| show | [out] A buffer in which to return true if the guides are visible. |
Reports whether page tiling is shown for the current view.
Each view has its own setting.
- Parameters:
-
| show | [out] A buffer in which to return true if page tiling is shown. |
Reports whether the transparency grid is shown in a view.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| show | [out] A buffer in which to return true if the transparency grid is visible. |
Reports whether there is a visible template layer.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| visible | [out] A buffer in which to return true if the template layer is shown. |
Determines the current state of video rulers if they are visible or not.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| visible | True if the artboard rulers are visible, false otherwise. |
Returns whether GPU Preview mode is enabled for the view.
[WIN Only]
- Parameters:
-
| view | The view reference, or NULL for the current view. |
- Returns:
- True if Accelerated Preview mode is ON, false if CPU rendering mode is on.
Determines whether the rulers are shown in Artboard co-ordinates.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| isYes | True if the rulers are shown in Artboard co-ordinates, false otherwise. |
Captures the contents of the view window (excluding scrollbars, etc.
) to a TIFF file. Artboards are centered in window before capture.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| saveFilename | Full path and name of TIFF file to create. |
| windowSize | Size to set window before capture. Will restore original window size before returning. |
Sets the video rulers visibility on or off.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| visible | True if artboard ruler visibility is to be turned on, false otherwise. |
Sets the point of the artboard that maps to the center of the window for a view.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| center | The new center point. |
Sets the invalid rectangle for all views of a viewed document.
This is the area that encloses (at least) the portions of the viewed document that have been changed and so need to be redrawn in all views of that document.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| invalidRect | The new area, in artwork coordinates. |
- See also:
SetDocumentViewInvalidRect()
Sets the invalid rectangle for a view.
This is the area that encloses (at least) the portions of the viewed document that have been changed and so need to be redrawn in the given view.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| invalidRect | The new area, in artwork coordinates. |
- See also:
GetDocumentViewInvalidRect() , SetDocumentViewInvalidDocumentRect()
Sets the display mode for a view.
Currently these flags are mostly mutually exclusive. kVsInk only makes sense combined with kVsPreview . kVsArtwork , kVsPreview , and kVsRaster are mutually exclusive.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| style | A logical OR of these bit flags:
kVsArtwork , kVsPreview , kVsRaster , kVsOpaque , kVsInk |
| mask | A logical OR of the same bit values as style indicating which bits from style to change. |
Sets the scale factor from artwork coordinates to window coordinates for a view.
The scale factor is silently clamped to lie between the minimum and maximum values supported (currently between 1/32 and 64). After adjusting the zoom, the document view center remains unchanged.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| zoom | The new zoom factor, a percentage value where 1 is 100% (actual size), 0.5 is 50% and 2 is 200%. |
Sets grid options for a view.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| show | True to make the grid visible, false to hide it. |
| snap | True to turn snap-to-grid on, false to turn it off. |
Set the visibility state for plate in the current view's plate state.
Visibility is only recognized for OPP view mode. Invalid plate identifiers are ignored.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| plate | Identifier for the plate to get the state of. |
| isOn | The new visibility state of plate . |
Sets the screen mode of a view.
In the UI, the screen mode is selected with icons at the bottom of the Tool palette.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| mode | The new screen mode. |
Sets the visibility state of the edges of the selection.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| show | True to make the edges visible, false to hide them. |
Sets the visibility state of the guides.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| show | True to make the guides visible, false to hide them. |
Sets the page tiling mode for the current view.
Each view has its own setting.
- Parameters:
-
| show | True to turn page tiling on, false to turn it off. |
Sets whether the transparency grid is shown in the view.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| show | True to make the transparency grid visible, false to hide it. |
Sets the rulers to use Artboard co-ordinates.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| state | True if the rulers are shown in Artboard co-ordinates, false otherwise. |
Converts a point from view coordinates to artwork coordinates.
- Parameters:
-
| view | The view reference, or NULL for the current view. |
| viewPoint | The point to convert, in window pixel coordinates. |
| artworkPoint | [out] A buffer in which to return the converted point, in artboard coordinates. |
- See also:
FixedViewPointToArtworkPoint() (takes floating-point coordinate values)
The documentation for this struct was generated from the following file:
|