AIEPSRenderRegion Class Reference

A render region for exporting EPS files in Adobe Illustrator 7.0 EPS format. More...

#include <ai_epsrr.h>

Inheritance diagram for AIEPSRenderRegion:

List of all members.

Public Member Functions
	AIEPSRenderRegion (DocRect ClipRect, Matrix ConvertMatrix, FIXED16 ViewScale)
	Create and initialise a render region for exporting AI EPS. Sets up the string to put in the %Creator comment.
	~AIEPSRenderRegion ()
BOOL	ExportBitmap (NodeBitmap *pNodeBMP)
	Kicks off the NodeBitmap export process..
BOOL	ExportBevel (NodeBevel *pBevel)
	Renders a bevel into a DIB, and exports this as a bitmap to the AI file.
BOOL	ExportShadow (OILBitmap *pBitmap, UINT32 Darkness, DocRect &Bounds)
	Renders a shadow into a DIB, and exports this as a bitmap to the AI file.
BOOL	ExportLayer (Layer *pLayer)
	If there is an existing layer, it writes the end of layer tags, before creating a new layer record.
BOOL	StartLayer (Layer *pLayer)
	Writes a layer record to the file.
virtual BOOL	RenderChar (WCHAR ch, Matrix *pMatrix)
	Overrides the default behaviour for rendering a single character. Used to store additional information on text blocks needed for AI text. i.e. the overflow text block ((xxxxxxxxx) TX) which occurs after the unjustified ((x) Tx (x) Tx ) block. Both of these are needed for correct Illustrator export of text.
BOOL	ExportingOnPath ()
	To determine whether this text is being exported on a path.
virtual void	OverflowTextStart ()
	Start the overflow text block.
virtual void	OverflowTextFinish ()
	Finish the overflow text block and write both blocks to the actual EPS file.
BOOL	WriteMask (Path *MaskPath, BOOL OutputGroupToken=FALSE)
	Creates a path that defines a masking pattern. All successive paths (until the end of mask operator) will be clipped to this shape.
virtual void	SetClipRegion (ClipRegionAttribute *pClipAttr, BOOL Temp)
	The Adobe Illustrator version of Karim's EPSRenderRegion::SetClipRegion, This was needed as Illustrator uses non-standard EPS commands.
virtual void	RestoreClipRegion (ClipRegionAttribute *pClipAttr, BOOL Temp)
	Adobe Illustrator version of Karim's EPSRenderRegion::RestoreClipRegion. See SetClipRegion for why this was necessary.
virtual void	SetTextAsShapes (BOOL shapes)
	Sets the export TextAsShapes flag.
virtual BOOL	GetTextAsShapes ()
	Sets the export TextAsShapes flag.
virtual BOOL	IsGradientFillValidForExport (FillGeometryAttribute *pFill)
	Determines whether a particular fill can be used through the AI export See also: AIEPSRenderRegion::WriteGradientFills, AIEPSRenderRegion::WriteGradientUsage.
virtual void	IncludeGradientFill (FillGeometryAttribute *pFill, EFFECTTYPE effect)
	Stores information about a fill so that the same fill isn't declared multiple times. See also: AIEPSRenderRegion::WriteGradientFills, AIEPSRenderRegion::WriteGradientUsage, AIEPSRenderRegion::FindGradientInCache.
Protected Member Functions
virtual void	Initialise ()
	Sets up render region - it outputs the AIEPS file header comments, and intialises the rendering attributes.
virtual BOOL	WriteEPSVersion ()
	Writes the relevant EPS version declaration.
virtual BOOL	WriteEPSProcessColours ()
	Writes the colour type used to disk.
virtual BOOL	WriteEPSResources (EPSFilter *pFilter, Document *pDocument)
	This function writes out the resource inclusion string required for the AI file.
virtual BOOL	WriteEPSProlog (EPSFilter *pFilter, Document *pDocument)
	This method writes out the initialisation code for the included resources.
virtual void	OutputFillColour (void)
	If the fill is a gradient fill, this method will invoke the WriteGradientFillInstance method, otherwise it will call the base EPSRenderRegion OutputFillColour method. This allows Camelot to support gradient fills in the AI file format.
virtual BOOL	WriteGradientFills (Document *pDocument)
	Parses through the tree, identifies any gradient fills, and writes them to the export DC's file.
virtual BOOL	WriteDocumentSetup (Document *pDocument, EPSFilter *pFilter)
	Browse through the tree, and if a text story is found invoke the document setup function. By only exporting the font setup when necessary, the file size produced is smaller (which makes it easier for me to interpret :) ), and it should hopefully make the filter run a bit faster too.
virtual BOOL	EndLayer (void)
	If there is an existing layer, it writes the end of layer tags, before creating a new layer record.
virtual void	OutputWindingRule ()
	Output the winding rule used to AI EPS.
virtual void	OutputStrokeColour ()
	Output the current stroke colour. This function will use one of the following EPS tokens K - if not separating and colour is unnamed X - if not separating and colour is named G - if separating.
virtual void	OutputLineWidth ()
	Output the standard line width token and measure for AI EPS.
virtual void	OutputJoinType ()
	Output the standard AI EPS join type.
virtual void	OutputDashPattern ()
	Outputs EPS dash pattern values. This function currently only exists so that extra handling can be easily achieved for Illustrator EPS export of dash patterns in the future (if need be).
virtual void	OutputStartCap ()
	Output the start cap setting using the usual 'J' EPS token.
virtual void	OutputMitreLimit ()
	Output the current mitre limit value using the usual 'M' EPS token. Again, this is only here so that the AI export can be easily expanded or modified.
virtual void	OutputFontName ()
	Output an Illustrator format fontname and pointsize token. The format is /_fontname[-Bold|-Italic|-BoldItalic] pointsize Tf. EncodeFontName will generate this format from an internal fontname. DocodeFontName will return an internal format fontname and flags where nec.
virtual void	OutputTextRenderMode ()
	Output the change in the text's Render Mode (Tr) - this happens when the text's fill or line colour changes to or from blank, see-through colour.
virtual void	OutputTextAspectRatio ()
	Output the change in the text's aspect ratio (Tz).
virtual void	OutputTextTracking ()
	Output the change in the tracking (Tt).
virtual void	OutputTextJustification ()
	Output the change in the text justification (Ta).
virtual void	OutputTextLineSpacing ()
	Output the change in the line spacing (Tl).
virtual void	OutputTextBaselineShift ()
	Output the change in Baseline shift (Ts).
virtual void	OutputTextSubSuperScript ()
	Output the change in the Sub/Super script attribute (Ts).
virtual void	OutputFillRGBColour ()
	Writes additional info to the file for RGB fill colours See also: EPSRenderRegion::OutputFillRGBColour.
virtual void	OutputFillCMYKColour ()
	Writes additional info to the file for CMYK fill colours See also: EPSRenderRegion::OutputFillCMYKColour.
virtual void	OutputStrokeRGBColour ()
	Writes additional info to the file for RGB stroke colours See also: EPSRenderRegion::OutputStrokeRGBColour.
virtual void	OutputStrokeCMYKColour ()
	Writes additional info to the file for CMYK fill colours See also: EPSRenderRegion::OutputFillCMYKColour.
virtual void	OverflowTextStartGap ()
	Starts a new gap in the Overflow text, so that attributes can be written into the overflow blocks (the TX ones).
virtual void	OverflowTextFinishGap ()
	Closes a gap for writing attributes in the overflow text, so that a new line of overflow text can be started.
virtual void	OverflowTextWrite (TCHAR *text)
	Write some text to the overflow body file. This will store all the text and modified attributes for the TX text block.
virtual void	OverflowTextWriteSingleColour (UINT32 n)
	Output a colour value to the overflow text file. A 'single colour' is a value as used in the Camelot 'Colour' class, i.e. in the range 0 to 255. This range is converted to the range 0.0 to 1.0, and output to the file.
virtual void	OverflowTextWriteColour (PColourCMYK *)
	Output a colour, as expressed by the Camelot 'Colour' class. This function takes the CMYK variation, is this is most appropriate to EPS files. Camelot colour values are converted from the 0-255 range to the 0.0-1.0 range before being output.
virtual void	OverflowTextWriteNamedColour (DocColour *, ColourContext *pContext=NULL)
	Similar to OutputColour(), except it outputs the colour name and tint of the colour as well. If pCol does not reference an indexed colour, then the name "NoName" is used.
virtual void	OverflowTextWriteColourName (DocColour *pCol)
	Outputs a named colour's name as a string. If pCol does not reference an indexed colour, then the name "NoName" is used. This was seperated from OutputNamedColour so that the DeviceContext will not need to worry about which ColourModel to use (CMYK, RGB, etc...), as this will be determined by the RenderRegion.
virtual BOOL	RenderCharAsShape (WCHAR ch, Matrix *pMatrix)
	Allows text to be drawn as shapes, not characters, so that AI can cope with gradient filled text.
virtual BOOL	WriteNewLine (void)
	Writes a new line to the output of text if text is exported as characters, does nothing if it's exported as shapes.
Private Member Functions
virtual void	BuildGradientCache (Node *pStartNode)
	Builds up a 'cache' of gradient fills.
virtual void	BuildGradientCacheUsingScanner (Node *pNode, AIEPSGradientScanRenderRegion *pScan)
	Builds up the gradient cache by scanning through each node under pNode for new fills.
virtual void	WriteGradientCount ()
	Writes out the count of all the gradient fills in the Cache.
virtual void	WriteGradientDefinitions ()
	Writes out the definitions of all the gradient fills in the Cache.
virtual void	ClearGradientCache ()
	Deletes the list of stored gradient fills, that was built up using IncludeGradientFill.
virtual INT32	FindGradientInCache (FillGeometryAttribute *pFill, EFFECTTYPE effect)
	Deletes the list of stored gradient fills, that was built up using IncludeGradientFill.
BOOL	WriteLinearFill (FillGeometryAttribute *pFill, EFFECTTYPE effect, INT32 id)
	Writes a linear fill to the disk file.
BOOL	WriteRadialFill (FillGeometryAttribute *pFill, EFFECTTYPE effect, INT32 id)
	Writes a Radial fill to the disk file.
virtual void	WriteGradientFillInstance ()
	This function identifies whether or not the current fill is a gradient fill, and writes in the appropriate values if it is. I've already created the records of the gradients themselves (see above), so this is just a case of matching the gradient with its ID, and Adobe Illustrator can then put the records together.
BOOL	WriteGradientEntry (DocColour *pColour, INT32 Position, INT32 Midpoint)
	Writes a line into the definition of a gradient fill.
BOOL	WriteFillEffectSteps (DocColour *pColour1, INT32 pos1, DocColour *pColour2, INT32 pos2, INT32 bias, EFFECTTYPE effect)
	Writes the additional entries required for a special fill effect (rainbow or alt-rainbow) to the gradient definition, as a series of steps. See Also: AIEPSRenderRegion::WriteGradientEntry AIEPSRenderRegion::WriteLinearFill AIEPSRenderRegion::WriteRadialFill.
BOOL	LoadBitmapMatrix (NodeBitmap *pNodeBMP)
	This code generates a matrix to position and manipulate a bitmap within an AI file. Roughly, it calculates the angle of rotation, followed by the skew angle, and creates a matrix using these values. See Also: FlashExportDC::WriteBitmapFill ().
BOOL	LoadTranslationMatrix (DocCoord &Translation)
	Loads the matrix with:.
BOOL	WriteLoadedMatrix (void)
	Writes a pre-loaded matrix to the file. I've added a couple of functions to create a matrix first, since it'll be more efficient to store the data, and re-write it as required, than to recalculate it twice.
BOOL	WriteMaskTags (void)
	Writes out the tags at the end of each block of a mask's definition.
BOOL	WriteBitmapRecord (OILBitmap *pBitmap)
	Creates a kernel bitmap instance within the AI file.
BOOL	WriteBitmapHeader (INT32 Width, INT32 Height)
	Writes the AI header for a bitmap record.
BOOL	WriteBitmapBody (OILBitmap *pBitmap, INT32 Width, INT32 Height)
	Writes the bitmap's data to the file.
BOOL	WriteContoneBody (OILBitmap *pBitmap)
	Writes a contone bitmap to the file as a 32bpp image.
BOOL	WriteBitmapTail (void)
	Wraps up the bitmap instance.
Private Attributes
ListFill *	m_pLinearGradList
ListFill *	m_pRadialGradList
double	m_a
double	m_b
double	m_c
double	m_d
DocCoord	m_T
BOOL	m_ActiveLayer
UINT32	m_LayerColour
FILE *	m_fpOverflowText
BOOL	m_bInTextGap
BOOL	m_bTextAsShapes
Friends
class	AIEPSGradientScanRenderRegion

---

Detailed Description

A render region for exporting EPS files in Adobe Illustrator 7.0 EPS format.

Author:

Tim_Browse (Xara Group Ltd) <camelotdev@xara.com>, extended by Graeme

Date:

08/03/94

See also:

EPSRenderRegion

Definition at line 207 of file ai_epsrr.h.

---

Constructor & Destructor Documentation

AIEPSRenderRegion::AIEPSRenderRegion (  DocRect  ClipRect, Matrix  ConvertMatrix, FIXED16  ViewScale )

Create and initialise a render region for exporting AI EPS. Sets up the string to put in the %Creator comment. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 29/3/00 See also: EPSRenderRegion::EPSRenderRegion () Definition at line 145 of file ai_epsrr.cpp. : EPSRenderRegion ( ClipRect, ConvertMatrix, ViewScale ) { // Set up member variables. m_a = 1; m_b = 0; m_c = 0; m_d = 1; m_T = DocCoord ( 0, 0 ); m_ActiveLayer = FALSE; m_LayerColour = 0; m_fpOverflowText = NULL; m_bInTextGap = FALSE; m_bTextAsShapes = FALSE; m_pLinearGradList = NULL; m_pRadialGradList = NULL; // Initialise the creator string to show that it's an AI file. CreatorString = _T("Adobe Illustrator(TM) 7.0 by Xara."); }

AIEPSRenderRegion::~AIEPSRenderRegion (   )

Definition at line 181 of file ai_epsrr.cpp. { ClearGradientCache (); }

---

Member Function Documentation

void AIEPSRenderRegion::BuildGradientCache (  Node *  pStartNode  )  [private, virtual]

Builds up a 'cache' of gradient fills. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 20/3/2001 Parameters: pStartNode  - the node to start looking from. [INPUTS] See also: AIEPSRenderRegion::WriteGradientFills, AIEPSRenderRegion::WriteGradientDefinitions Definition at line 3601 of file ai_epsrr.cpp. { // Node * pChild = NULL; // Set up the gradient searching system AIEPSGradientScanRenderRegion scanRR (this); scanRR.AttachDevice (DocView::GetSelected (), RenderDC, RenderView->GetDoc()->FindFirstSpread ()); scanRR.InitDevice (); // Although the counting system does return the number of fills found, it can be got from // the scanner just as easily. BuildGradientCacheUsingScanner (pStartNode, &scanRR); }

void AIEPSRenderRegion::BuildGradientCacheUsingScanner (  Node *  pNode, AIEPSGradientScanRenderRegion *  pScan )  [private, virtual]

Builds up the gradient cache by scanning through each node under pNode for new fills. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 20/3/2001 Parameters: pNode  - the node to start looking from. [INPUTS] pScan - the scanner to use See also: AIEPSRenderRegion::WriteGradientFills, AIEPSRenderRegion::WriteGradientDefinitions Definition at line 3631 of file ai_epsrr.cpp. { // Children are rendered first, so that attributes will be applied to the right objects. Node * pChild = pNode->FindFirstChild (); while (pChild!=NULL) { BuildGradientCacheUsingScanner (pChild, pScan); pChild = pChild->FindNext (); } // "Render" the node into the scanner. Currently, rendering is the only way to access // the intermediate steps (and their attributes) in blends, contours and some others, // so we need to use a special Render Region to catch the gradient (fill) information. // // NOTE: Since this uses the same system as the main render loop, it shouldn't be possible // for the gradient cache and the main file to become out of sync. Also, bevels and // shadows are excluded, as they are rendered as bitmaps in AI export. if (!pNode->IsABevel () && !pNode->IsAShadow ()) pNode->Render (pScan); }

void AIEPSRenderRegion::ClearGradientCache (   )  [private, virtual]

Deletes the list of stored gradient fills, that was built up using IncludeGradientFill. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 30/3/2001 See also: AIEPSRenderRegion::IncludeGradientFill, AIEPSRenderRegion::FindGradientInCache Definition at line 3495 of file ai_epsrr.cpp. { ListFill * pList = NULL; // only clear it if there is a list to clear if (m_pLinearGradList) { // Cycle through the linear list deleting each item in turn. while (m_pLinearGradList != NULL) { pList = m_pLinearGradList->pNext; delete m_pLinearGradList; m_pLinearGradList = pList; } } if (m_pRadialGradList) { // Cycle through the radial list deleting each item in turn. while (m_pRadialGradList != NULL) { pList = m_pRadialGradList->pNext; delete m_pRadialGradList; m_pRadialGradList = pList; } } }

BOOL AIEPSRenderRegion::EndLayer (  void   )  [protected, virtual]

If there is an existing layer, it writes the end of layer tags, before creating a new layer record. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 11/4/00 Parameters: -  [INPUTS] Returns: TRUE - Success. FALSE - An error occured. See also: AIEPSRenderRegion::ExportLayer () Reimplemented from EPSRenderRegion. Definition at line 1219 of file ai_epsrr.cpp. { // Only act if there's an active layer. if ( m_ActiveLayer ) { // Cast the RenderDC pointer into a useful form. KernelDC *pDC = static_cast<KernelDC *> ( CCDC::ConvertFromNativeDC(RenderDC) ); // Write out the end of layer tag. pDC->OutputToken ( _T("LB") ); pDC->OutputNewLine (); pDC->OutputToken ( _T("%AI5_EndLayer") ); pDC->OutputNewLine (); // Set m_ActiveLayer to be FALSE. m_ActiveLayer = FALSE; } return TRUE; }

BOOL AIEPSRenderRegion::ExportBevel (  NodeBevel *  pBevel  )

Renders a bevel into a DIB, and exports this as a bitmap to the AI file. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 6/4/00 Parameters: pBevel  - A pointer to a bevel node. [INPUTS] Returns: TRUE - Success. FALSE - An error occured. See also: NodeBevel::ExportRender Definition at line 228 of file ai_epsrr.cpp. { // Set up the local variables. KernelDC *pDC = static_cast<KernelDC *> ( CCDC::ConvertFromNativeDC(RenderDC) ); RangeControl ControlFlags ( TRUE, TRUE ); Range ToRender ( pBevel, pBevel, ControlFlags ); KernelBitmap *pBitmap = NULL; Path *pSourcePath = &( pBevel->InkPath ); DocRect Bounds = pBevel->GetBoundingRect (); DocCoord Position ( Bounds.lo.x, Bounds.hi.y ); double Width = static_cast<double> ( Bounds.Width () ); double Height = static_cast<double> ( Bounds.Height () ); // Create and render the bitmap. pBitmap = pBevel->CreateBitmapCopy(-1.0,FALSE); if(!pBitmap) return FALSE; // Get the width and height of the bitmap. double BMPWidth = static_cast<double> ( pBitmap->GetWidth () ); double BMPHeight = static_cast<double> ( pBitmap->GetHeight () ); // Write the path. (ChrisG 16/01/01) If we have one. if (pSourcePath->GetNumCoords () != 0) { WriteMask ( pSourcePath, TRUE ); } // Set up the bitmap translation matrix. LoadTranslationMatrix ( Position ); // Scale width and height to be valid value for AI co-ordinates. Width /= 1000; Height /= 1000; // And calcuate the scale values for placing the bitmap. m_a = Width / BMPWidth; m_d = Height / BMPHeight; // Write the bitmap record. WriteBitmapRecord ( pBitmap->ActualBitmap ); // Write the end of mask operator. (ChrisG 16/01/01) If we've written a mask. if (pSourcePath->GetNumCoords () != 0) { pDC->OutputToken ( _T("Q") ); pDC->OutputNewLine (); } if(pBitmap) { pBitmap->DestroyGreyscaleVersion(); delete pBitmap; } // Success! return TRUE; }

BOOL AIEPSRenderRegion::ExportBitmap (  NodeBitmap *  pNodeBMP  )

Kicks off the NodeBitmap export process.. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 31/3/00 Parameters: pNodeBMP  - A pointer to the NodeBitmap being exported. [INPUTS] Returns: TRUE - If successful. FALSE - If an error is encountered. See also: NodeBitmap::ExportRender () Definition at line 200 of file ai_epsrr.cpp. { // Set up the local variables. KernelBitmap *pBitmap = pNodeBMP->GetBitmap (); // Set up the bitmap's transformation matrix. LoadBitmapMatrix ( pNodeBMP ); // Write out the bitmap record. WriteBitmapRecord ( pBitmap->GetActualBitmap () ); return TRUE; }

BOOL AIEPSRenderRegion::ExportingOnPath (   )

To determine whether this text is being exported on a path. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 2/11/00 Returns: TRUE - yes, we are exporting on a path FALSE - no, we aren't exporting on a path See also: Definition at line 2578 of file ai_epsrr.cpp. { if (m_fpOverflowText) return TRUE; else return FALSE; }

BOOL AIEPSRenderRegion::ExportLayer (  Layer *  pLayer  )

If there is an existing layer, it writes the end of layer tags, before creating a new layer record. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 11/4/00 Parameters: pLayer  - A pointer to a layer object. [INPUTS] Returns: TRUE - Success. FALSE - An error occured. See also: AIEPSRenderRegion::EndLayer () Definition at line 358 of file ai_epsrr.cpp. { // Tidy up the existing layer, if it exists. EndLayer (); // And write out the next layer. return StartLayer ( static_cast<Layer*> ( pLayer->FindNext ( CC_RUNTIME_CLASS ( Layer ) ) ) ); }

BOOL AIEPSRenderRegion::ExportShadow (  OILBitmap *  pBitmap, UINT32  Darkness, DocRect &  Bounds )

Renders a shadow into a DIB, and exports this as a bitmap to the AI file. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 11/4/00 Parameters: pShadow  - A pointer to a shadow node. [INPUTS] Returns: TRUE - Success. FALSE - An error occured. See also: NodeBevel::ExportRender Definition at line 304 of file ai_epsrr.cpp. { // Set up the local variables. // KernelDC *pDC = (KernelDC*)CCDC::ConvertFromNativeDC(RenderDC); DocCoord Position ( Bounds.lo.x, Bounds.hi.y ); double Width = static_cast<double> ( Bounds.Width () ) / 1000; double Height = static_cast<double> ( Bounds.Height () ) / 1000; double BMPWidth = static_cast<double> ( pBitmap->GetWidth () ); double BMPHeight = static_cast<double> ( pBitmap->GetHeight () ); DocColour ShadowColour = *( static_cast<FillGeometryAttribute*> ( GetCurrentAttribute ( ATTR_FILLGEOMETRY ) ) ->GetStartColour () ); DocColour BlendedShadow = AlphaBlend ( ShadowColour, mBackgroundColour, Darkness ); // And use the shadow colour to build a contone bitmap palette. pBitmap->BuildContonePalette ( BlendedShadow, mBackgroundColour, EFFECT_RGB, RenderView ); // Set up the bitmap translation matrix. LoadTranslationMatrix ( Position ); // And calcuate the scale values for placing the bitmap. m_a = Width / BMPWidth; m_d = Height / BMPHeight; // Write out the bitmap header. WriteBitmapHeader ( (INT32)BMPWidth, (INT32)BMPHeight ); // Export the bitmap. WriteContoneBody ( pBitmap ); // Finish off the bitmap record. WriteBitmapTail (); return TRUE; }

INT32 AIEPSRenderRegion::FindGradientInCache (  FillGeometryAttribute *  pFill, EFFECTTYPE  effect )  [private, virtual]

Deletes the list of stored gradient fills, that was built up using IncludeGradientFill. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 30/3/2001 Returns the identifier of the found gradient fill, or 0 if it wasn't found See also: AIEPSRenderRegion::IncludeGradientFill, Definition at line 3538 of file ai_epsrr.cpp. { INT32 id = 0; ListFill * pList = NULL; FillGeometryAttribute * pStoredFill = NULL; double fillBias = 0; CProfileBiasGain fillProfile = pFill->GetProfile (); fillBias = (double) fillProfile.GetBias (); // work out which list we want to search in. if (pFill->IsARadialFill () || pFill->IsASquareFill ()) pList = m_pRadialGradList; else pList = m_pLinearGradList; // Cycle through all the fills until we find the one we want, or until we run out of fills while ((pList != NULL) && (id == 0)) { pStoredFill = pList->pFill; // Because the start and end points for an Illustrator fill are not included in the // cache, we don't need to worry about them being the same. // // So, we set all the start and end points to be the same (since they would cause two // identical fills in different places, or of different lengths to be considered as // different otherwise). pStoredFill->SetStartPoint (pFill->GetStartPoint ()); pStoredFill->SetEndPoint (pFill->GetEndPoint ()); pStoredFill->SetEndPoint2 (pFill->GetEndPoint2 ()); pStoredFill->SetEndPoint3 (pFill->GetEndPoint3 ()); // Now that the fill coords are the same, test to see whether they're // the same fill, or not. if (*pStoredFill == *pFill) { double storeBias = 0; CProfileBiasGain storeProfile = pStoredFill->GetProfile (); storeBias = (double) storeProfile.GetBias (); if ((storeBias == fillBias) && (pList->effect == effect)) id = pList->id; } // Check the next fill pList = pList->pNext; } return id; }

BOOL AIEPSRenderRegion::GetTextAsShapes (   )  [virtual]

Sets the export TextAsShapes flag. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 8th November 2000 Returns: BOOL - whether text is exported as shapes (TRUE) or characters (FALSE) See also: AIEPSRenderRegion::GetTextAsShapes Definition at line 3036 of file ai_epsrr.cpp. { return m_bTextAsShapes; }

void AIEPSRenderRegion::IncludeGradientFill (  FillGeometryAttribute *  pFill, EFFECTTYPE  effect )  [virtual]

Stores information about a fill so that the same fill isn't declared multiple times. See also: AIEPSRenderRegion::WriteGradientFills, AIEPSRenderRegion::WriteGradientUsage, AIEPSRenderRegion::FindGradientInCache. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 5/2/2001 Definition at line 3416 of file ai_epsrr.cpp. { ERROR3IF ((pFill == NULL), "AIEPSRenderRegion::IncludeGradientFill - Attempted to include NULL fill"); ListFill * pNewList = NULL; FillGeometryAttribute * pNewFill = NULL; // don't try and store the fill if it's invalid. if (pFill != NULL) { // Create a new FillGeometryAttribute, of the same type as the one passed in. // NOTE: Four colour fills are derived from three colour fills, so they return // TRUE for IsAThreeColFill. This means that we need to process four colour // fills before we process three colour fills, otherwise all four colour fills // will become represented by three colour ones and the copy won't match the // original. if (pFill->IsALinearFill ()) pNewFill = new LinearFillAttribute; else if (pFill->IsARadialFill ()) pNewFill = new RadialFillAttribute; else if (pFill->IsAConicalFill ()) pNewFill = new ConicalFillAttribute; else if (pFill->IsASquareFill ()) pNewFill = new SquareFillAttribute; else if (pFill->IsAFourColFill ()) pNewFill = new FourColFillAttribute; else if (pFill->IsAThreeColFill ()) pNewFill = new ThreeColFillAttribute; else if (pFill->IsAFractalFill ()) pNewFill = new FractalFillAttribute; else if (pFill->IsANoiseFill ()) pNewFill = new NoiseFillAttribute; else if (pFill->IsABitmapFill ()) pNewFill = new BitmapFillAttribute; else { pNewFill = NULL; ERROR3 ("AIEPSRenderRegion::IncludeGradientFill - Unrecognised fill included"); } // Copy fill data if the the fill is recognised. There's no point in doing this if // we didn't recognise the fill, as the copy is bound to be different to the original. if (pNewFill != NULL) { // Copy all the relevant info. *(pNewFill) = *pFill; ERROR3IF ( !(*pFill == *pNewFill), "AIEPSRenderRegion::IncludeGradientFill - Copied fill doesn't match original"); // New Fill is built, so add it into either the radial or linear list. if (pFill->IsARadialFill () || pFill->IsASquareFill ()) { pNewList = new ListFill (pNewFill, effect, m_pRadialGradList); m_pRadialGradList = pNewList; } else { pNewList = new ListFill (pNewFill, effect, m_pLinearGradList); m_pLinearGradList = pNewList; } } } }

void AIEPSRenderRegion::Initialise (   )  [protected, virtual]

Sets up render region - it outputs the AIEPS file header comments, and intialises the rendering attributes. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 29/3/00 See also: EPSRenderRegion::Initialise, EPSRenderRegion::InitAttributes Definition at line 531 of file ai_epsrr.cpp. { // Set up member variables. m_a = 1; m_b = 0; m_c = 0; m_d = 1; m_T = DocCoord ( 0, 0 ); m_ActiveLayer = FALSE; m_LayerColour = 0; ClearGradientCache (); // Call the EPSRenderRegion method to re-enter the export loop. EPSRenderRegion::InitAttributes (); }

BOOL AIEPSRenderRegion::IsGradientFillValidForExport (  FillGeometryAttribute *  pFill  )  [virtual]

Determines whether a particular fill can be used through the AI export See also: AIEPSRenderRegion::WriteGradientFills, AIEPSRenderRegion::WriteGradientUsage. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 15/01/01 Definition at line 3383 of file ai_epsrr.cpp. { BOOL acceptable = FALSE; if ( pFill->IsAColourFill () && // Is it a colour fill? pFill->IsAGradFill () && // Is it a graduated fill? ! (pFill->IsAFractalFill ()) && // Is it not a fractal (clouds) fill? ! (pFill->IsANoiseFill ()) && // Is it not a fractal (plasma) fill? ! (pFill->IsABitmapFill ()) ) // Is it not a bitmap fill? { acceptable = TRUE; } else { acceptable = FALSE; } return acceptable; }

BOOL AIEPSRenderRegion::LoadBitmapMatrix (  NodeBitmap *  pNodeBMP  )  [private]

This code generates a matrix to position and manipulate a bitmap within an AI file. Roughly, it calculates the angle of rotation, followed by the skew angle, and creates a matrix using these values. See Also: FlashExportDC::WriteBitmapFill (). Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 4/4/00 Parameters: pNodeBitmap  - A pointer to the bitmap node being exported. [INPUTS] Returns: TRUE - Successful. FALSE - An error has occured. Definition at line 1402 of file ai_epsrr.cpp. { // Step 1: Extract the co-ordinates of three corners from the bitmap record, and store // them as named co-ordinates within this function. The names are a historical // reference to the original names within the FlashExportDC, and refer to the // positions of a bitmap fill. double Angle = pNodeBMP->GetRotationAngle (); double SinRotate = sin ( Angle ); double CosRotate = cos ( Angle ); // double Skew = 0; DocCoord LowLeft = pNodeBMP->Parallel [3]; // Low corner of the bitmap. DocCoord TopLeft = pNodeBMP->Parallel [0]; // Max Y corner. DocCoord LowRight = pNodeBMP->Parallel [2]; // Max X corner. // Step 2: Calculate the normalised dot product of the two vectors, and this forms // the cosine of their internal angle. double WidthX = static_cast<double> ( LowLeft.x - LowRight.x ) / 1000; double WidthY = static_cast<double> ( LowLeft.y - LowRight.y ) / 1000; double HeightX = static_cast<double> ( TopLeft.x - LowLeft.x ) / 1000; double HeightY = static_cast<double> ( TopLeft.y - LowLeft.y ) / 1000; // Get the lengths of these vectors to normalise the dot-product. (Necessary for the // trignometric function calculations.) double Width = sqrt ( ( WidthX * WidthX ) + ( WidthY * WidthY ) ); double Height = sqrt ( ( HeightX * HeightX ) + ( HeightY * HeightY ) ); /* // The dot product calculation. By normalising the result, the cosine of the angle is // calculated. double CosSkew = ( ( WidthX * HeightX ) + ( HeightY * WidthY ) ) / ( Height * Width ); double SinSkew = sqrt ( 1 - ( CosSkew * CosSkew ) ); // Multiply the width of the shape by the sine derived from the dot product. This will // give the actual width, and not the one distorted by skewing. Width *= SinSkew; // If the DotSine value is not 0, calculate the tan value that forms the skew angle. // Since tan is undefined for 0, I'm ignoring this state. if ( SinSkew != 0 ) { Skew = - CosSkew / SinSkew; } */ // Grab a reference to the bitmap, and pull it's height and width from it. KernelBitmap *pBitmap = pNodeBMP->GetBitmap (); // A reference to the bitmap. double BMPWidth = static_cast<double> ( pBitmap->GetWidth () ); double BMPHeight = static_cast<double> ( pBitmap->GetHeight () ); // Catch BMPWidth or BMPHeight set to zero. This shouldn't happen... if ( BMPWidth == 0 ) BMPWidth = 1; if ( BMPHeight == 0 ) BMPHeight = 1; // Step 4: Use the above values to calculate the values with which to populate the // transformation matrix. double ScaleX = Width / BMPWidth; double ScaleY = Height / BMPHeight; // Step 5: Use these to build the matrix. The variables a, b, c, d refer to the AI // matrix entries. The form of the matrix is: // // | SinRotate CosRotate | | ScaleX 0 | // | -CosRotate SinRotate | | Skew * ScaleY ScaleY | m_a = ( SinRotate * ScaleX ); // + ( CosRotate * Skew * ScaleY ); m_b = ( - CosRotate * ScaleX ); // + ( SinRotate * Skew * ScaleY ); m_c = CosRotate * ScaleY; m_d = SinRotate * ScaleY; // There's a weird bug with the AI export, in that a small (>0.0001) value is misread // by Adobe Illustrator as a monstrous value. To get around this, I'm going to set all // near zero values to zero. if ( Absol ( m_a ) < 1e-4 ) { m_a = 0; } if ( Absol ( m_b ) < 1e-4 ) { m_b = 0; } if ( Absol ( m_c ) < 1e-4 ) { m_c = 0; } if ( Absol ( m_d ) < 1e-4 ) { m_d = 0; } // Step 6: Calculate the translation part of the matrix. m_T = TopLeft; return TRUE; }

BOOL AIEPSRenderRegion::LoadTranslationMatrix (  DocCoord &  Translation  )  [private]

Loads the matrix with:. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 10/4/00 Parameters: -  [INPUTS] Returns: TRUE - Success. FALSE - An error occured. | 1 0 Translation.x | | 0 1 Translation.y | Which can then be written with WriteLoadedMatrix. See also: AIESPRenderRegion::LoadBitmapMatrix, AIEPSRenderRegion::WriteLoadedMatrix Definition at line 1524 of file ai_epsrr.cpp. { // Set the transformation part of the matrix to be the identity matrix. m_a = 1; m_b = 0; m_c = 0; m_d = 1; // And load up the translation value. m_T = Translation; return TRUE; }

void AIEPSRenderRegion::OutputDashPattern (   )  [protected, virtual]

Outputs EPS dash pattern values. This function currently only exists so that extra handling can be easily achieved for Illustrator EPS export of dash patterns in the future (if need be). Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 See also: EPSRenderRegion::OutputDashPattern (); EPSRenderRegion::OutputDashPatternInit(); Reimplemented from EPSRenderRegion. Definition at line 2141 of file ai_epsrr.cpp. { EPSRenderRegion::OutputDashPattern (); }

void AIEPSRenderRegion::OutputFillCMYKColour (   )  [protected, virtual]

Writes additional info to the file for CMYK fill colours See also: EPSRenderRegion::OutputFillCMYKColour. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 18/12/00 Reimplemented from EPSRenderRegion. Definition at line 3167 of file ai_epsrr.cpp. { // NOTE: We need to export any changes to the overflow text here, // as it's the last place we can catch the colour change. if (ExportingOnPath ()) { PColourCMYK CMYK; OverflowTextStartGap (); // Assume no local context at present ColourContext* pContext; ColourPlate* pSeparation; GetOutputColourPlate(COLOURMODEL_CMYK, &pContext, &pSeparation); if (pSeparation==NULL) { // Get the current line colour in CMYK values, unless it's transparent // Print out colour component values. if (RR_FILLCOLOUR().FindParentIndexedColour() == NULL) { // Unnamed colour // retrieve the colour value RR_FILLCOLOUR().GetCMYKValue(pContext, &CMYK); OverflowTextWriteColour (&CMYK); OverflowTextWrite (_T("k\n")); } else { // Named colour OverflowTextWriteNamedColour (&(RR_FILLCOLOUR()), pContext); OverflowTextWrite (_T("x\n")); } } else { // Assume unnamed colour as 'g' grey fill operator does // not allow for custom greys. if (pSeparation->IsMonochrome()) { RR_FILLCOLOUR().GetCMYKValue(pContext, &CMYK); BYTE c = 0xFF - CMYK.Key; OverflowTextWriteSingleColour (c); OverflowTextWrite (_T("g\n")); } else { RR_FILLCOLOUR().GetCMYKValue(pContext, &CMYK); OverflowTextWriteColour (&CMYK); OverflowTextWrite (_T("x\n")); } } } // Call the base class to write the ordinary info out EPSRenderRegion::OutputFillCMYKColour (); }

void AIEPSRenderRegion::OutputFillColour (  void   )  [protected, virtual]

If the fill is a gradient fill, this method will invoke the WriteGradientFillInstance method, otherwise it will call the base EPSRenderRegion OutputFillColour method. This allows Camelot to support gradient fills in the AI file format. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 29/3/00 (ChrisG 30/3/2001) - Gradient fill instances should be exported when they are used on an object, not when a fill attribute is found. This way, fills can be applied to multiple objects. See also: AIEPSRenderRegion::OutputStrokeColour Reimplemented from EPSRenderRegion. Definition at line 1380 of file ai_epsrr.cpp. { // Output the actual fill colour. EPSRenderRegion::OutputFillColour (); }

void AIEPSRenderRegion::OutputFillRGBColour (   )  [protected, virtual]

Writes additional info to the file for RGB fill colours See also: EPSRenderRegion::OutputFillRGBColour. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 18/12/00 Reimplemented from EPSRenderRegion. Definition at line 3088 of file ai_epsrr.cpp. { // NOTE: We need to export any changes to the overflow text here, // as it's the last place we can catch the colour change. if (ExportingOnPath ()) { OverflowTextStartGap (); // Colour values. INT32 red; INT32 green; INT32 blue; PColourCMYK CMYK; // Assume no local context at present - used as a check to make sure that we // aren't exporting as seperations. ColourContext* pContext; ColourPlate* pSeparation; GetOutputColourPlate (COLOURMODEL_CMYK, &pContext, &pSeparation); if (pSeparation==NULL) { // As expected, we ain't using seperations, so we can output as RGB. // Get the current line colour in RGB values and print them out. RR_FILLCOLOUR().GetRGBValue (&red, &green, &blue); OverflowTextWriteSingleColour (red); OverflowTextWriteSingleColour (green); OverflowTextWriteSingleColour (blue); if (RR_FILLCOLOUR().FindParentIndexedColour() == NULL) { // Unnamed colour - just add 'Xa' token OverflowTextWrite (_T("Xa\n")); } else { // Named colour - add Name, tint value, RGB flag and 'Xx' token OverflowTextWriteColourName (&(RR_FILLCOLOUR())); OverflowTextWrite (_T(" 0 1 Xx\n")); } } else { // Since we are seperating the colours, then use CMYK mode. // Assume unnamed colour as 'g' grey fill operator does // not allow for custom greys. if (pSeparation->IsMonochrome()) { RR_FILLCOLOUR().GetCMYKValue(pContext, &CMYK); BYTE c = 0xFF - CMYK.Key; OverflowTextWriteSingleColour (c); OverflowTextWrite (_T("g\n")); } else { RR_FILLCOLOUR().GetCMYKValue(pContext, &CMYK); OverflowTextWriteColour (&CMYK); OverflowTextWrite (_T("x\n")); } } } // Write out the usual EPS colour tokens. EPSRenderRegion::OutputFillRGBColour (); }

void AIEPSRenderRegion::OutputFontName (  void   )  [protected, virtual]

Output an Illustrator format fontname and pointsize token. The format is /_fontname[-Bold|-Italic|-BoldItalic] pointsize Tf. EncodeFontName will generate this format from an internal fontname. DocodeFontName will return an internal format fontname and flags where nec. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 Reimplemented from EPSRenderRegion. Definition at line 2234 of file ai_epsrr.cpp. { if (ExportingOnPath ()) { TCHAR buffer [64]; OverflowTextStartGap (); String_64 FontName; String_64 EncodedFontName; String_64 Append(_T("/_")); // get information about the current font FONTMANAGER->GetFontName(RR_TXTFONTTYPEFACE(), FontName); // Graeme (31-3-00) - I've lifted this piece of code from the CamelotEPSRenderRegion. It // appears to map an existing, encoded font name onto its Postscript counterpart. FONTMANAGER->EncodeAndMapFontName(FontName, EncodedFontName, GetFontStyle()); EncodedFontName.Insert(Append,0); // Output the fontsize next double PointSize = ((double)RR_TXTFONTSIZE())/1000; // finally do output the font token camSprintf (buffer, _T("%s %.1f Tf\n"), (TCHAR *)EncodedFontName, PointSize); OverflowTextWrite (buffer); } EPSRenderRegion::OutputFontName (); }

void AIEPSRenderRegion::OutputJoinType (   )  [protected, virtual]

Output the standard AI EPS join type. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 Reimplemented from EPSRenderRegion. Definition at line 2110 of file ai_epsrr.cpp. { TCHAR buf [64]; // Set line Join Type if (ExportingOnPath ()) { OverflowTextStartGap (); camSprintf (buf, _T("%d j\n"), (UINT32)RR_JOINTYPE()); OverflowTextWrite (buf); } EPSRenderRegion::OutputJoinType (); }

void AIEPSRenderRegion::OutputLineWidth (   )  [protected, virtual]

Output the standard line width token and measure for AI EPS. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 Reimplemented from EPSRenderRegion. Definition at line 2084 of file ai_epsrr.cpp. { TCHAR buf [64]; // Set line width if (ExportingOnPath ()) { OverflowTextStartGap (); camSprintf (buf, _T("%.2f w\n"), ((double) RR_LINEWIDTH())/1000); OverflowTextWrite (buf); } EPSRenderRegion::OutputLineWidth (); }

void AIEPSRenderRegion::OutputMitreLimit (   )  [protected, virtual]

Output the current mitre limit value using the usual 'M' EPS token. Again, this is only here so that the AI export can be easily expanded or modified. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 Reimplemented from EPSRenderRegion. Definition at line 2184 of file ai_epsrr.cpp. { EPSRenderRegion::OutputMitreLimit (); }

void AIEPSRenderRegion::OutputStartCap (   )  [protected, virtual]

Output the start cap setting using the usual 'J' EPS token. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 Reimplemented from EPSRenderRegion. Definition at line 2157 of file ai_epsrr.cpp. { TCHAR buf [64]; if (ExportingOnPath ()) { OverflowTextStartGap (); camSprintf (buf, _T("%d J\n"), (UINT32)RR_STARTCAP()); OverflowTextWrite (buf); } EPSRenderRegion::OutputStartCap (); }

void AIEPSRenderRegion::OutputStrokeCMYKColour (   )  [protected, virtual]

Writes additional info to the file for CMYK fill colours See also: EPSRenderRegion::OutputFillCMYKColour. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 18/12/00 Reimplemented from EPSRenderRegion. Definition at line 3316 of file ai_epsrr.cpp. { // Write out the colour to the overflow file if we're doing text on a path. if (ExportingOnPath ()) { PColourCMYK CMYK; OverflowTextStartGap (); // Assume no local context at present ColourContext* pContext; ColourPlate* pSeparation; GetOutputColourPlate(COLOURMODEL_CMYK, &pContext, &pSeparation); if (pSeparation==NULL) { // Get the current line colour in CMYK values, unless it's transparent // Print out colour component values. if (RR_STROKECOLOUR().FindParentIndexedColour() == NULL) { // Unnamed colour // retrieve the colour value RR_STROKECOLOUR().GetCMYKValue(pContext, &CMYK); OverflowTextWriteColour (&CMYK); OverflowTextWrite (_T("K\n")); } else { // Named colour OverflowTextWriteNamedColour (&(RR_STROKECOLOUR()), pContext); OverflowTextWrite (_T("X\n")); } } else { // Assume unnamed colour as 'g' grey fill operator does // not allow for custom greys. if (pSeparation->IsMonochrome()) { RR_STROKECOLOUR().GetCMYKValue(pContext, &CMYK); BYTE c = 0xFF - CMYK.Key; OverflowTextWriteSingleColour (c); OverflowTextWrite (_T("G\n")); } else { RR_STROKECOLOUR().GetCMYKValue(pContext, &CMYK); OverflowTextWriteColour (&CMYK); OverflowTextWrite (_T("X\n")); } } } // Call the base class to write out the ordinary information EPSRenderRegion::OutputStrokeCMYKColour (); }

void AIEPSRenderRegion::OutputStrokeColour (   )  [protected, virtual]

Output the current stroke colour. This function will use one of the following EPS tokens K - if not separating and colour is unnamed X - if not separating and colour is named G - if separating. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 See also: AIEPSRenderRegion::OutputFillColour Reimplemented from EPSRenderRegion. Definition at line 2208 of file ai_epsrr.cpp. { // Write out the stroke colour EPSRenderRegion::OutputStrokeColour (); }

void AIEPSRenderRegion::OutputStrokeRGBColour (   )  [protected, virtual]

Writes additional info to the file for RGB stroke colours See also: EPSRenderRegion::OutputStrokeRGBColour. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 18/12/00 Reimplemented from EPSRenderRegion. Definition at line 3236 of file ai_epsrr.cpp. { // NOTE: We need to export any changes to the overflow text here, // as it's the last place we can catch the colour change. if (ExportingOnPath ()) { OverflowTextStartGap (); // Colour values. INT32 red; INT32 green; INT32 blue; PColourCMYK CMYK; // Assume no local context at present - used as a check to make sure that we // aren't exporting as seperations. ColourContext* pContext; ColourPlate* pSeparation; GetOutputColourPlate (COLOURMODEL_CMYK, &pContext, &pSeparation); if (pSeparation==NULL) { // As expected, we ain't using seperations, so we can output as RGB. // Get the current line colour in RGB values and print them out. RR_STROKECOLOUR().GetRGBValue (&red, &green, &blue); OverflowTextWriteSingleColour (red); OverflowTextWriteSingleColour (green); OverflowTextWriteSingleColour (blue); if (RR_STROKECOLOUR().FindParentIndexedColour() == NULL) { // Unnamed colour - just add 'XA' token OverflowTextWrite (_T("XA\n")); } else { // Named colour - add Name, tint value, RGB flag and 'XX' token OverflowTextWriteColourName (&(RR_STROKECOLOUR())); OverflowTextWrite (_T(" 0 1 XX\n")); } } else { // Since we are seperating the colours, then use CMYK mode. // Assume unnamed colour as 'g' grey fill operator does // not allow for custom greys. if (pSeparation->IsMonochrome()) { RR_STROKECOLOUR().GetCMYKValue(pContext, &CMYK); BYTE c = 0xFF - CMYK.Key; OverflowTextWriteSingleColour (c); OverflowTextWrite (_T("G\n")); } else { RR_STROKECOLOUR().GetCMYKValue(pContext, &CMYK); OverflowTextWriteColour (&CMYK); OverflowTextWrite (_T("X\n")); } } } // Call the base class to process the colour normally (i.e. to the EPS file itself) EPSRenderRegion::OutputStrokeRGBColour (); }

void AIEPSRenderRegion::OutputTextAspectRatio (   )  [protected, virtual]

Output the change in the text's aspect ratio (Tz). Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 Reimplemented from EPSRenderRegion. Definition at line 2322 of file ai_epsrr.cpp. { TCHAR buf [64]; if (ExportingOnPath ()) { OverflowTextStartGap (); camSprintf (buf, _T("%.0f Tz\n"), (RR_TXTASPECTRATIO().MakeDouble()*100.0)); // convert from ratio to % OverflowTextWrite (buf); } EPSRenderRegion::OutputTextAspectRatio (); }

void AIEPSRenderRegion::OutputTextBaselineShift (   )  [protected, virtual]

Output the change in Baseline shift (Ts). Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 Reimplemented from EPSRenderRegion. Definition at line 2475 of file ai_epsrr.cpp. { TCHAR buf [64]; // Output baseline shift in points // format = rise Ts if (ExportingOnPath ()) { OverflowTextStartGap (); double BaseLine = ((double)RR_TXTBASELINE())/1000; camSprintf (buf, _T("%.1f Ts\n"), BaseLine); OverflowTextWrite (buf); } EPSRenderRegion::OutputTextBaselineShift (); }

void AIEPSRenderRegion::OutputTextJustification (   )  [protected, virtual]

Output the change in the text justification (Ta). Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 Reimplemented from EPSRenderRegion. Definition at line 2377 of file ai_epsrr.cpp. { TCHAR buf [64]; if (ExportingOnPath ()) { OverflowTextStartGap (); switch (RR_TXTJUSTIFICATION()) { case JLEFT: camSprintf (buf, _T("%d Ta\n"), ((INT32)0)); break; case JRIGHT: camSprintf (buf, _T("%d Ta\n"), ((INT32)2)); break; case JCENTRE: camSprintf (buf, _T("%d Ta\n"), ((INT32)1)); break; case JFULL: camSprintf (buf, _T("%d Ta\n"), ((INT32)3)); break; } OverflowTextWrite (buf); } EPSRenderRegion::OutputTextJustification (); }

void AIEPSRenderRegion::OutputTextLineSpacing (   )  [protected, virtual]

Output the change in the line spacing (Tl). Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 Reimplemented from EPSRenderRegion. Definition at line 2416 of file ai_epsrr.cpp. { if (ExportingOnPath ()) { TCHAR buf [64]; OverflowTextStartGap (); // Output line spacing in points. // format - paraspace linespace Tl double ptLineSpace; double ptParaSpace=0; TxtLineSpaceAttribute* pLineSpace = (TxtLineSpaceAttribute*)(CurrentAttrs[ATTR_TXTLINESPACE].pAttr); // There are some rules for reading the linespacing value which I shall divulge // If IsARation is true then use the proportinal linespacing value. // else use the absolute linespacing // However if the absolute linespacing is zero, then we MUST use the proportional // linespacing. Eeek! // ie it is an error if (absolute==0 && !IsARatio()) which we will check for here double FontSize = (double)RR_TXTFONTSIZE(); // in millipoints 12pt = 12000 mp double absLineSpace = (double)pLineSpace->Value; double proLineSpace = (pLineSpace->Ratio).MakeDouble(); BOOL Proportional = pLineSpace->IsARatio(); if (!Proportional && absLineSpace==0) { ERROR3("Absolute line spacing is zero yet IsARatio() is FALSE, in GetValidTextAttributes()"); // Make sure we use the proportional value no matter what. Proportional=TRUE; } if (Proportional) ptLineSpace = FontSize*proLineSpace/1000; else ptLineSpace = absLineSpace/1000; camSprintf (buf, _T("%.0f %.0f Tl\n"), ptLineSpace, ptParaSpace); OverflowTextWrite (buf); } EPSRenderRegion::OutputTextLineSpacing (); }

void AIEPSRenderRegion::OutputTextRenderMode (   )  [protected, virtual]

Output the change in the text's Render Mode (Tr) - this happens when the text's fill or line colour changes to or from blank, see-through colour. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 Reimplemented from EPSRenderRegion. Definition at line 2278 of file ai_epsrr.cpp. { INT32 Style=0; if (ExportingOnPath ()) { OverflowTextStartGap (); // Is there a currently active fill colour? if (! (RR_FILLCOLOUR().IsTransparent()) ) Style+=1; // Is there a currently active line colour? if (! (RR_STROKECOLOUR().IsTransparent()) ) Style+=2; switch (Style) { case 0: OverflowTextWrite (_T("3 Tr\n")); // Invisible break; case 1: OverflowTextWrite (_T("0 Tr\n")); // filled only break; case 2: OverflowTextWrite (_T("1 Tr\n")); // stroked only break; case 3: OverflowTextWrite (_T("2 Tr")); // filled and stroked break; } } EPSRenderRegion::OutputTextRenderMode (); }

void AIEPSRenderRegion::OutputTextSubSuperScript (   )  [protected, virtual]

Output the change in the Sub/Super script attribute (Ts). Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 Reimplemented from EPSRenderRegion. Definition at line 2503 of file ai_epsrr.cpp. { TCHAR buf [64]; if (ExportingOnPath ()) { OverflowTextStartGap (); // Output sub/superscript // in millipoints 12pt = 12000 mp double FontSize = ((double)RR_TXTFONTSIZE())/1000; TxtScriptAttribute* pScript = RR_TXTSCRIPT(); double offset = (pScript->Offset).MakeDouble(); double size = (pScript->Size).MakeDouble(); OverflowTextWrite (_T("%%XSScript\n")); double rise = FontSize*offset; camSprintf (buf, _T("%.1f Ts\n"), rise); OverflowTextWrite (buf); double ptsize = FontSize*size; String_64 MappedFont; String_64 Append(_T("/_")); String_64 FontName; FONTMANAGER->GetFontName(RR_TXTFONTTYPEFACE(), FontName); // Graeme (31-3-00) - Map the encoded name onto the PS font name. FONTMANAGER->EncodeAndMapFontName(FontName,MappedFont,GetFontStyle()); // Graeme (14-6-00) - I should add ascent and descent values, but Camelot doesn't // seem to store them anywhere. MappedFont.Insert(Append,0); camSprintf (buf, _T("%s %.1f Tf\n"),(TCHAR *)MappedFont, ptsize); // Output the ascent. // Output the descent. OverflowTextWrite (buf); } EPSRenderRegion::OutputTextSubSuperScript (); }

void AIEPSRenderRegion::OutputTextTracking (   )  [protected, virtual]

Output the change in the tracking (Tt). Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 Reimplemented from EPSRenderRegion. Definition at line 2348 of file ai_epsrr.cpp. { // Must be output in 1/1000 of an em. // 1 em = point size of font. // Tracking internally =millipoints. TCHAR buf [64]; if (ExportingOnPath ()) { OverflowTextStartGap (); camSprintf (buf, _T("%d Tt\n"), RR_TXTTRACKING()); OverflowTextWrite (buf); } EPSRenderRegion::OutputTextTracking (); }

void AIEPSRenderRegion::OutputWindingRule (   )  [protected, virtual]

Output the winding rule used to AI EPS. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 19/12/00 Reimplemented from EPSRenderRegion. Definition at line 2046 of file ai_epsrr.cpp. { // Set up kernel DC up in an appropriate form. KernelDC *pDC = static_cast<KernelDC *> ( CCDC::ConvertFromNativeDC(RenderDC) ); if (RR_WINDINGRULE() == EvenOddWinding) { // Even-Odd winding (Camelot's default) pDC->OutputValue ((INT32)1); } else if (RR_WINDINGRULE() == NonZeroWinding) { // Non-Zero winding (EPS's default) pDC->OutputValue ((INT32)0); } else { // Positive or negative winding (only Even-Odd and Non-Zero are supported in AI7), // so assume that we're using camelot's default rule. pDC->OutputValue ((INT32)1); } pDC->OutputToken (_T("XR")); pDC->OutputNewLine (); }

void AIEPSRenderRegion::OverflowTextFinish (   )  [virtual]

Finish the overflow text block and write both blocks to the actual EPS file. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 See also: Definition at line 2620 of file ai_epsrr.cpp. { ASSERT (m_fpOverflowText); // write out final information. OverflowTextStartGap (); // close files. fclose (m_fpOverflowText); m_fpOverflowText = NULL; // copy info into actual EPS file. char cbuffer [1025]; TCHAR buffer [1025]; KernelDC *pDC = (KernelDC*)CCDC::ConvertFromNativeDC(RenderDC); FILE * fp; // Write out the Extra info. fp = fopen ("OverFlow.txt", "r+t"); while (fgets (cbuffer, 1024, fp) != NULL) { char c; INT32 i=0; cbuffer[1024]=0; do { c=cbuffer[i]; buffer[i]=c; // 1:1 CHAR->TCHAR conversion i++; } while (c); // deal with newlines. pDC->OutputToken (buffer); pDC->OutputNewLine (); } fclose (fp); // clean up temp. files remove ("OverFlow.txt"); }

void AIEPSRenderRegion::OverflowTextFinishGap (   )  [protected, virtual]

Closes a gap for writing attributes in the overflow text, so that a new line of overflow text can be started. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 2/11/00 See also: AIEPSRenderRegion::OverflowTextStartGap (); Definition at line 2699 of file ai_epsrr.cpp. { ASSERT (ExportingOnPath ()); // if we're in a text gap (for changing the attributes), start writing a new TX block. if (m_bInTextGap == TRUE) { OverflowTextWrite (_T("(")); m_bInTextGap = FALSE; } }

void AIEPSRenderRegion::OverflowTextStart (   )  [virtual]

Start the overflow text block. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 See also: Definition at line 2598 of file ai_epsrr.cpp. { // open overflow file m_fpOverflowText = fopen ("OverFlow.txt", "w"); // write out start info - NOTE: we're currently in a gap from writing the initial // attributes, so we're going to have to close it. m_bInTextGap = TRUE; }

void AIEPSRenderRegion::OverflowTextStartGap (   )  [protected, virtual]

Starts a new gap in the Overflow text, so that attributes can be written into the overflow blocks (the TX ones). Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 2/11/00 See also: AIEPSRenderRegion::OverflowTextFinishGap () Definition at line 2675 of file ai_epsrr.cpp. { ASSERT (ExportingOnPath ()); // if we're not in a gap, finish writing the old TX block and start a new gap, if (m_bInTextGap == FALSE) { OverflowTextWrite (_T(") TX\n")); m_bInTextGap = TRUE; } }

void AIEPSRenderRegion::OverflowTextWrite (  TCHAR *  text  )  [protected, virtual]

Write some text to the overflow body file. This will store all the text and modified attributes for the TX text block. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 See also: Definition at line 2724 of file ai_epsrr.cpp. { ASSERT (ExportingOnPath ()); while (*text) { fprintf (m_fpOverflowText, "%c", *text++); } }

void AIEPSRenderRegion::OverflowTextWriteColour (  PColourCMYK *  pCol  )  [protected, virtual]

Output a colour, as expressed by the Camelot 'Colour' class. This function takes the CMYK variation, is this is most appropriate to EPS files. Camelot colour values are converted from the 0-255 range to the 0.0-1.0 range before being output. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 3/11/00 Parameters: Col  - the CMYK colour values to be output. [INPUTS] e.g. MonoOn PColourCMYK Col = { 255, 255, 128, 0 }; pDC->OutputColour(&Col); MonoOff will give the following output: MonoOn 1.0 1.0 0.5 0.0 MonoOff See also: KernelDC::OutputColourValue Returns: Errors: Disk/file error => ERROR1 Definition at line 2784 of file ai_epsrr.cpp. { // Write each of the colour values. OverflowTextWriteSingleColour (pCol->Cyan); OverflowTextWriteSingleColour (pCol->Magenta); OverflowTextWriteSingleColour (pCol->Yellow); OverflowTextWriteSingleColour (pCol->Key); }

void AIEPSRenderRegion::OverflowTextWriteColourName (  DocColour *  pCol  )  [protected, virtual]

Outputs a named colour's name as a string. If pCol does not reference an indexed colour, then the name "NoName" is used. This was seperated from OutputNamedColour so that the DeviceContext will not need to worry about which ColourModel to use (CMYK, RGB, etc...), as this will be determined by the RenderRegion. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 18/12/00 Parameters: pCol  - the colour to output. [INPUTS] See also: KernelDC::OutputNamedColour Returns: Errors: Disk/file error => ERROR1 Definition at line 2875 of file ai_epsrr.cpp. { // Get the indexed colour from the DocColour. IndexedColour *pIndCol = pCol->FindParentIndexedColour(); if (pIndCol == NULL) { if (pCol->IsTransparent()) { // This is a 'no colour' type colour, so output a zero-length colour name, // as this is the only way we can handle this at the moment. OverflowTextWrite (_T("()")); } else { // Otherwise make up a colour name (see epsfiltr.h). OverflowTextWrite (_T("(")); OverflowTextWrite (ImmediateColourFudgeyBodgeName); OverflowTextWrite (_T(")")); } } else { // Got an indexed colour - output its name // (Pass in TRUE to get a unique-identifier for local colours rather than "Local colour") String_64 *ColName = pIndCol->GetName(TRUE); OverflowTextWrite (_T("(")); OverflowTextWrite ((TCHAR *) (*ColName)); OverflowTextWrite (_T(")")); } }

void AIEPSRenderRegion::OverflowTextWriteNamedColour (  DocColour *  pCol, ColourContext *  pContext = NULL )  [protected, virtual]

Similar to OutputColour(), except it outputs the colour name and tint of the colour as well. If pCol does not reference an indexed colour, then the name "NoName" is used. Author: Tim_Browse (Xara Group Ltd) <camelotdev@xara.com> Date: 09/08/94 Parameters: pCol  - the colour to output. [INPUTS] pContext - the context to use to convert the colour before output. if this is NULL the default CMYK context will be used. Returns: TRUE if the data was written ok; FALSE if not => ERROR1 See also: KernelDC::OutputColour Returns: Errors: Disk/file error => ERROR1 Definition at line 2813 of file ai_epsrr.cpp. { // Get CMYK version of this colour. PColourCMYK CMYK; pCol->GetCMYKValue(pContext, &CMYK); // Output CMYK version OverflowTextWriteColour (&CMYK); // Get the indexed colour from the DocColour. IndexedColour *pIndCol = pCol->FindParentIndexedColour(); // Cope with the unexpected! // ENSURE(pIndCol != NULL, "Named colour has no index colour!"); if (pIndCol == NULL) { if (pCol->IsTransparent()) { // This is a 'no colour' type colour, so output a zero-length colour name, // as this is the only way we can handle this at the moment. return; } else { // Otherwise make up a colour name (see epsfiltr.h). OverflowTextWrite (_T("(")); OverflowTextWrite (ImmediateColourFudgeyBodgeName); OverflowTextWrite (_T(")")); } } else { // Got an indexed colour - output its name // (Pass in TRUE to get a unique-identifier for local colours rather than "Local colour") String_64 *ColName = pIndCol->GetName(TRUE); OverflowTextWrite (_T("(")); OverflowTextWrite ((TCHAR *) (*ColName)); OverflowTextWrite (_T(")")); } // Always tint 0 OverflowTextWrite (_T(" 0 ")); }

void AIEPSRenderRegion::OverflowTextWriteSingleColour (  UINT32  n  )  [protected, virtual]

Output a colour value to the overflow text file. A 'single colour' is a value as used in the Camelot 'Colour' class, i.e. in the range 0 to 255. This range is converted to the range 0.0 to 1.0, and output to the file. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 3/11/00 Parameters: n  - the colour value (range 0-255) to write to the EPS file. [INPUTS] See also: KernelDC::OutputColourValue Definition at line 2748 of file ai_epsrr.cpp. { // Output to string TCHAR buf[20]; // Convert to points, getting integer and fractional parts camSprintf (buf, _T("%.2f "), ((double) n) / 255); OverflowTextWrite (buf); }

BOOL AIEPSRenderRegion::RenderChar (  WCHAR  ch, Matrix *  pMatrix )  [virtual]

Overrides the default behaviour for rendering a single character. Used to store additional information on text blocks needed for AI text. i.e. the overflow text block ((xxxxxxxxx) TX) which occurs after the unjustified ((x) Tx (x) Tx ) block. Both of these are needed for correct Illustrator export of text. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 See also: EPSRenderRegion::RenderChar Reimplemented from EPSRenderRegion. Definition at line 446 of file ai_epsrr.cpp. { TCHAR buf[20]; BOOL result = FALSE; // assume failure if nothing given. if (m_bTextAsShapes) { result = RenderCharAsShape (ch, pMatrix); } else { // Output matrix (a b c d e f Tm\n) - a,b,c and d are in the range 1.0 to -1.0 // Only do this for text on paths if (ExportingOnPath ()) { KernelDC *pDC = (KernelDC*)CCDC::ConvertFromNativeDC(RenderDC); pDC->OutputMatrix(pMatrix); pDC->OutputToken(_T("Tm")); pDC->OutputNewLine(); } // call the base class first, so that the attributes are exported BEFORE the character result = EPSRenderRegion::RenderChar (ch, pMatrix);; // store any extra information, closing an attribute gap if one is open. if (ExportingOnPath ()) { OverflowTextFinishGap (); camSprintf (buf,_T("%c"),ch); OverflowTextWrite (buf); } } // Call the base class' function to do the standard export. return result; }

BOOL AIEPSRenderRegion::RenderCharAsShape (  WCHAR  ch, Matrix *  pMatrix )  [protected, virtual]

Allows text to be drawn as shapes, not characters, so that AI can cope with gradient filled text. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 1/11/00 See also: AIEPSRenderRegion::RenderChar, EPSRenderRegion::RenderChar Definition at line 496 of file ai_epsrr.cpp. { BOOL result = FALSE; // create the char's path Path* pCharPath=CreateCharPath(ch,pMatrix); // if the path got created correctly, then we done good... if (pCharPath!=NULL) { // if at least one point, draw path using current attibutes in render region if (pCharPath->GetNumCoords()!=0) DrawPath(pCharPath); // clean up delete pCharPath; result = TRUE; } return result; }

void AIEPSRenderRegion::RestoreClipRegion (  ClipRegionAttribute *  pClipAttr, BOOL  Temp )  [virtual]

Adobe Illustrator version of Karim's EPSRenderRegion::RestoreClipRegion. See SetClipRegion for why this was necessary. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 8th November 2000 Parameters: pClipAttr  ptr to the ClipRegionAttribute to restore over the current one. [INPUTS] Temp whether the attr is temporary or not. Postscript  is told to restore its last saved context. [OUTPUTS] Restore the RR's clipping region. We do this by recording a restore-state command. Returns: Errors: ERROR3 if the current ClipRegionAttribute holds a NULL clip-path ptr. This state of affairs should not happen. You can't set a ClipRegionAttribute with a NULL clip-path ptr, so the only such attr is the default one, and you should never be restoring over _that_. See also: RenderRegion::RestoreClipRegion(), EPSRenderRegion::RestoreClipRegion() Reimplemented from EPSRenderRegion. Definition at line 2982 of file ai_epsrr.cpp. { // we should never be entered when the current clipattr has a NULL path, as what this // means is that either somebody somehow did a SetClipRegion() with such an attr, or // somebody is trying to Restore() over the default ClipRegionAttribute (which holds a // NULL path ptr). Neither of these actions should occur. if (RR_CLIPREGION()->GetClipPath() == NULL) { ERROR3("EPSRenderRegion::RestoreClipRegion; Current ClipRegionAttribute has a NULL path"); } else { // Update the RR's table of current attributes. RenderRegion::RestoreClipRegion(pClipAttr, Temp); } }

void AIEPSRenderRegion::SetClipRegion (  ClipRegionAttribute *  pClipAttr, BOOL  Temp )  [virtual]

The Adobe Illustrator version of Karim's EPSRenderRegion::SetClipRegion, This was needed as Illustrator uses non-standard EPS commands. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 8th November 2000 Parameters: pClipAttr  ptr to the new ClipRegionAttribute to set as current in our RR. [INPUTS] Temp whether the attr is temporary or not. Postscript's  context is saved and the commands are output to intersect its [OUTPUTS] current clipping path with that defined by the ClipAttr. Also, the RR's current attr context is updated to use this new ClipAttr. Shrink the RR's clipping region to the region defined by pClipAttr. We do this by: 1. Recording a save-state command. 2. Exporting a description of the clipping path in pClipAttr. 3. Recording a 'clip-to-last-path' command. 4. Recording a 'start-new-path' command, as we don't want our clip-path to get stroked or rendered in any way. Notes: We mustn't record clipping commands when rendering the default attribute. Therefore this method does *nothing whatsoever* unless pClipAttr's ptr to its clipping-path is non-NULL. This ptr is NULL in the default attr. See also: RenderRegion::SetClipRegion(), EPSRenderRegion::SetClipRegion() Reimplemented from EPSRenderRegion. Definition at line 2942 of file ai_epsrr.cpp. { if (pClipAttr->GetClipPath() != NULL) { // Update the RR's table of current attributes. RenderRegion::SetClipRegion (pClipAttr, Temp); // Write out the clipping path as a mask. WriteMask(pClipAttr->GetClipPath(), pClipAttr->IsResponsibleForGrouping ()); } }

void AIEPSRenderRegion::SetTextAsShapes (  BOOL  shapes  )  [virtual]

Sets the export TextAsShapes flag. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 8th November 2000 Parameters: shapes  - whether to export text as shapes (TRUE) or characters (FALSE) [INPUTS] See also: AIEPSRenderRegion::RenderChar(), TextStory::PreExportRender, TextStory::ExportRender Definition at line 3016 of file ai_epsrr.cpp. { m_bTextAsShapes = shapes; }

BOOL AIEPSRenderRegion::StartLayer (  Layer *  pLayer  )

Writes a layer record to the file. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 11/4/00 Parameters: pLayer  - A pointer to a layer object. [INPUTS] Returns: TRUE - Success. FALSE - An error occured. See also: AIEPSRenderRegion::EndLayer () Definition at line 382 of file ai_epsrr.cpp. { // Catch null pointers to layers. if ( pLayer != NULL ) { KernelDC *pDC = static_cast<KernelDC *> ( CCDC::ConvertFromNativeDC(RenderDC) ); TCHAR LayerName [258]; // Set up the layer's name. camSprintf ( LayerName, _T("(%s)"), ( TCHAR* ) pLayer->GetLayerID () ); // Start a layer definition. pDC->OutputToken ( _T("%AI5_BeginLayer") ); pDC->OutputNewLine (); // Set the layer's properties. pDC->OutputValue ( ( UINT32 ) pLayer->IsVisible () ); // Is the layer visible? pDC->OutputValue ( ( UINT32 ) 1 ); // Is the layer previewed? pDC->OutputValue ( ( UINT32 ) !pLayer->IsLocked () ); // Is the layer enabled? pDC->OutputValue ( ( UINT32 ) pLayer->IsPrintable () );//Is the layer printable? pDC->OutputValue ( ( UINT32 ) 0 ); // Is the layer dimmed? pDC->OutputValue ( ( UINT32 ) 0 ); // No multilayer masks. // The ID colour. pDC->OutputValue ( ( UINT32 ) m_LayerColour % 27 ); // Set the layer's ID colour. m_LayerColour ++; // Increment colour ID. // Colour values - I don't know what they're used for. pDC->OutputValue ( ( UINT32 ) 0 ); // Red intensity. pDC->OutputValue ( ( UINT32 ) 0 ); // Blue intensity. pDC->OutputValue ( ( UINT32 ) 0 ); // Green intensity. // Write out the Lb tag. pDC->OutputToken ( _T("Lb") ); pDC->OutputNewLine (); // Set the layer's name. pDC->OutputToken ( LayerName ); pDC->OutputToken ( _T("Ln") ); pDC->OutputNewLine (); // Tell Camelot that there is an active layer. m_ActiveLayer = TRUE; } // Success! return TRUE; }

BOOL AIEPSRenderRegion::WriteBitmapBody (  OILBitmap *  pBitmap, INT32  Width, INT32  Height )  [private]

Writes the bitmap's data to the file. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 13/4/00 Parameters: pBitmap  - A pointer to the OIL bitmap object being rendered. [INPUTS] Width - The width of the bitmap in pixels. Height - The height of the bitmap in pixels. Returns: TRUE - If successful. FALSE - If an error is encountered. See also: NodeBitmap::ExportRender () Definition at line 1871 of file ai_epsrr.cpp. { // Set up the local variables. KernelDC *pDC = static_cast<KernelDC*> ( CCDC::ConvertFromNativeDC(RenderDC) ); INT32 Count = 0; // Write the initial %. pDC->OutputToken ( _T("%") ); // Write out the bitmap data. It's necessary to go backwards through y // otherwise the bitmap is rendered upside down. for ( INT32 y = Height - 1; y >= 0; y-- ) { for ( INT32 x = 0; x < Width; x++ ) { Pixel32bpp BMPPixel = pBitmap->ReadPixel32bpp ( x, y ); TCHAR Output [7]; // Wrap the line to keep the file tidy. if ( Count >= 10 ) { pDC->OutputNewLine (); pDC->OutputToken ( _T("%") ); Count = 0; } // Translate the RGB values into an ASCII string. camSprintf ( Output, _T("%.2X%.2X%.2X"), BMPPixel.Red, BMPPixel.Green, BMPPixel.Blue ); // And output them. I'm writing directly to the file because the OutputToken () // function introduces spaces between the values, which is not a good thing for // the AI file format. This way, it's much happier. :) if ( !pDC->OutputTCHARAsChar ( Output, 6 ) ) { // There's been a problem. return FALSE; } Count ++; } } // Write a new line after the bitmap record, to keep things tidy. pDC->OutputNewLine (); return TRUE; }

BOOL AIEPSRenderRegion::WriteBitmapHeader (  INT32  Width, INT32  Height )  [private]

Writes the AI header for a bitmap record. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 13/4/00 Parameters: Width  - The width (in pixels) of the bitmap image. [INPUTS] Height - The height (in pixels) of the bitmap image. Returns: TRUE - If successful. FALSE - If an error is encountered. See also: NodeBitmap::ExportRender () Definition at line 1791 of file ai_epsrr.cpp. { // Set up kernel DC up in an appropriate form. KernelDC *pDC = static_cast<KernelDC *> ( CCDC::ConvertFromNativeDC(RenderDC) ); // Declare the bitmap record. pDC->OutputToken ( _T("%AI5_File:") ); pDC->OutputNewLine (); pDC->OutputToken ( _T("%AI5_BeginRaster") ); pDC->OutputNewLine (); // (ChrisG 23/11/00) The Xh operator has been removed, as it wasn't correct (it didn't // have the third, unknown, value), it isn't in the Illustrator File Format Manual, // and all the information in it seems to be duplicated in the standard XI operator, // which is written out immediately after the Xh one was. // The matrix. // WriteLoadedMatrix (); // Height and width. (and an extra value - as there's no mention of this token in the // Illustrator file format manual, I have no idea what it signifies, but Photoshop // needs it, or else it gives MPS Parser Errors). // pDC->OutputValue ( Width ); // pDC->OutputValue ( Height ); // pDC->OutputValue ( 0l ); // pDC->OutputToken ( _T("Xh") ); // pDC->OutputNewLine (); // Write out the XI operator. // The matrix. WriteLoadedMatrix (); // The bounds of the bitmap. pDC->OutputToken ( _T("0 0") ); pDC->OutputValue ( Width ); pDC->OutputValue ( Height ); // Height and width. Note: The AI documentation puts their order the other // way around, but the AI export from Fireworks uses this order. pDC->OutputValue ( Width ); pDC->OutputValue ( Height ); // These values are always constant, and so I don't need to worry about // them changing. pDC->OutputToken ( _T("8 3 0 0 0 0") ); pDC->OutputNewLine (); // Write out the file size. pDC->OutputToken ( _T("%%BeginData:") ); pDC->OutputValue ( static_cast<INT32> ( Height * Width * 3 ) ); pDC->OutputNewLine (); // Wrap out the XI operator. pDC->OutputToken ( _T("XI") ); pDC->OutputNewLine (); return TRUE; }

BOOL AIEPSRenderRegion::WriteBitmapRecord (  OILBitmap *  pBitmap  )  [private]

Creates a kernel bitmap instance within the AI file. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 10/4/00 Parameters: pBitmap  - A pointer to the OIL bitmap object being rendered. [INPUTS] Returns: TRUE - If successful. FALSE - If an error is encountered. See also: NodeBitmap::ExportRender () Definition at line 1755 of file ai_epsrr.cpp. { // Set up the local variables. // KernelDC *pDC = static_cast<KernelDC*> ( CCDC::ConvertFromNativeDC(RenderDC) ); INT32 Width = static_cast<INT32> ( pBitmap->GetWidth () ); INT32 Height = static_cast<INT32> ( pBitmap->GetHeight () ); // Write out the bitmap header. WriteBitmapHeader ( Width, Height ); // Write out the body. WriteBitmapBody ( pBitmap, Width, Height ); // Finish off the bitmap record. WriteBitmapTail (); // It worked! return TRUE; }

BOOL AIEPSRenderRegion::WriteBitmapTail (  void   )  [private]

Wraps up the bitmap instance. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 13/4/00 Parameters: -  [INPUTS] Returns: TRUE - If successful. FALSE - If an error is encountered. See also: NodeBitmap::ExportRender () Definition at line 2006 of file ai_epsrr.cpp. { // Set up kernel DC up in an appropriate form. KernelDC *pDC = static_cast<KernelDC *> ( CCDC::ConvertFromNativeDC(RenderDC) ); // Wrap up the bitmap record. pDC->OutputToken ( _T("%%EndData") ); pDC->OutputNewLine (); pDC->OutputToken ( _T("XH") ); pDC->OutputNewLine (); pDC->OutputToken ( _T("%AI5_EndRaster") ); pDC->OutputNewLine (); // ChrisG (27/10/00). // This token was changed from 'N' close unfilled path, to 'F' close filled path. The // latter preserves information about the current line width, join type, fill colour, // etc... Whereas the 'N' token clears all this info, so any text objects or paths which // follow the bitmap were picking up colour and line info for an unfilled/unstroked path, // rather than the current attributes. pDC->OutputToken ( _T("F") ); pDC->OutputNewLine (); // The colours are no longer valid, as the bitmap definition has invalidated them. m_bValidPathAttrs = FALSE; m_bValidTextAttrs = FALSE; return TRUE; }

BOOL AIEPSRenderRegion::WriteContoneBody (  OILBitmap *  pBitmap  )  [private]

Writes a contone bitmap to the file as a 32bpp image. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 13/4/00 Parameters: pBitmap  - A pointer to the OIL bitmap object being rendered. [INPUTS] Returns: TRUE - If successful. FALSE - If an error is encountered. See also: NodeBitmap::ExportRender () Definition at line 1935 of file ai_epsrr.cpp. { // Set up the local variables. KernelDC *pDC = static_cast<KernelDC*> ( CCDC::ConvertFromNativeDC(RenderDC) ); INT32 Width = static_cast<INT32> ( pBitmap->GetWidth () ); INT32 Height = static_cast<INT32> ( pBitmap->GetHeight () ); INT32 Count = 0; // Write the initial %. pDC->OutputToken ( _T("%") ); // Write out the bitmap data. It's necessary to go backwards through y // otherwise the bitmap is rendered upside down. for ( INT32 y = Height - 1; y >= 0; y-- ) { for ( INT32 x = 0; x < Width; x++ ) { UINT32 Index = pBitmap->ReadPixelGreyscale ( x, y ); DocColour PixelColour = pBitmap->GetContonePaletteEntry ( Index ); TCHAR Output [7]; INT32 lRed; INT32 lGreen; INT32 lBlue; // Extract the values from the DocColour. PixelColour.GetRGBValue ( &lRed, &lGreen, &lBlue ); // Wrap the line to keep the file tidy. if ( Count >= 10 ) { pDC->OutputNewLine (); pDC->OutputToken ( _T("%") ); Count = 0; } // Translate the RGB values into an ASCII string. camSprintf ( Output, _T("%.2X%.2X%.2X"), lRed, lGreen, lBlue ); // And output them. I'm writing directly to the file because the OutputToken () // function introduces spaces between the values, which is not a good thing for // the AI file format. This way, it's much happier. :) if ( !pDC->OutputTCHARAsChar ( Output, 6 ) ) { // There's been a problem. return FALSE; } Count ++; } } // Write a new line after the bitmap record, to keep things tidy. pDC->OutputNewLine (); return TRUE; }

BOOL AIEPSRenderRegion::WriteDocumentSetup (  Document *  pDocument, EPSFilter *  pFilter )  [protected, virtual]

Browse through the tree, and if a text story is found invoke the document setup function. By only exporting the font setup when necessary, the file size produced is smaller (which makes it easier for me to interpret :) ), and it should hopefully make the filter run a bit faster too. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 24/3/00 Parameters: pDocument  - The document being outputted. [INPUTS] pFilter - A pointer to the export filter. -  [OUTPUTS] Returns: TRUE if successful. FALSE if error (e.g. file/disk error) Reimplemented from EPSRenderRegion. Definition at line 1177 of file ai_epsrr.cpp. { // Get the spread from the document. Spread *pSpread = pDocument->FindFirstSpread (); Node *pTextStory = NULL; // Try to find a single instance of the TextStory node. pTextStory = SliceHelper::FindNextOfClass ( pSpread, pSpread, CC_RUNTIME_CLASS ( TextStory ) ); // If something was found... if ( pTextStory != NULL ) { // ... write out the font set-up. pDocument->WriteEPSSetup ( pFilter ); } else { // Otherwise just get the relevant bits. pDocument->AIExportExtras ( pFilter->GetExportDC () ); } // It worked! return TRUE; }

BOOL AIEPSRenderRegion::WriteEPSProcessColours (  void   )  [protected, virtual]

Writes the colour type used to disk. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 28/3/000 Parameters: pDC  - The device context to output to. [INPUTS] Returns: TRUE if ok; FALSE if error (e.g. file/disk error or printer driver error) See also: EPSRenderRegion::WriteEPSProcessColours Reimplemented from EPSRenderRegion. Definition at line 588 of file ai_epsrr.cpp. { // Cast a pointer to the appropriate DC. KernelDC *pDC = (KernelDC*)CCDC::ConvertFromNativeDC(RenderDC); // Output the process colours pDC->OutputToken ( _T("%%DocumentProcessColors: Cyan Magenta Yellow Black") ); pDC->OutputNewLine (); return TRUE; }

BOOL AIEPSRenderRegion::WriteEPSProlog (  EPSFilter *  pFilter, Document *  pDocument )  [protected, virtual]

This method writes out the initialisation code for the included resources. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 28/3/00 Parameters: pDC  - The device context to output to. [INPUTS] Returns: TRUE if ok; FALSE if error (e.g. file/disk error or printer driver error) See also: EPSRenderRegion::WriteSetup Reimplemented from EPSRenderRegion. Definition at line 650 of file ai_epsrr.cpp. { // Call the export method in the document. pDocument->WriteEPSProlog ( pFilter ); // All done. return TRUE; }

BOOL AIEPSRenderRegion::WriteEPSResources (  EPSFilter *  pFilter, Document *  pDocument )  [protected, virtual]

This function writes out the resource inclusion string required for the AI file. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 28/3/00 Parameters: pDC  - The device context to output to. [INPUTS] Returns: TRUE if ok; FALSE if error (e.g. file/disk error or printer driver error) See also: EPSRenderRegion::WriteSetup Reimplemented from EPSRenderRegion. Definition at line 616 of file ai_epsrr.cpp. { // Cast a pointer to the appropriate DC. KernelDC *pDC = (KernelDC*)CCDC::ConvertFromNativeDC(RenderDC); // Call the export method in the document. pDocument->WriteEPSResources ( pFilter ); // Add a few things necessary for the AI file format. pDC->OutputToken ( _T("%AI3_ColorUsage: Color") ); pDC->OutputNewLine (); pDC->OutputToken ( _T("%AI5_FileFormat 2.0") ); pDC->OutputNewLine (); // All done. return TRUE; }

BOOL AIEPSRenderRegion::WriteEPSVersion (  void   )  [protected, virtual]

Writes the relevant EPS version declaration. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 28/3/000 Parameters: pDC  - The device context to output to. [INPUTS] Returns: TRUE if ok; FALSE if error (e.g. file/disk error or printer driver error) See also: EPSRenderRegion::WriteEPSVersion Reimplemented from EPSRenderRegion. Definition at line 562 of file ai_epsrr.cpp. { // Cast the pointer to an appropriate DC. KernelDC *pDC = static_cast<KernelDC *> ( CCDC::ConvertFromNativeDC(RenderDC) ); // Output the special AIEPS header start token. pDC->OutputToken ( _T("%!PS-Adobe-3.0") ); pDC->OutputNewLine (); return TRUE; }

BOOL AIEPSRenderRegion::WriteFillEffectSteps (  DocColour *  pColour1, INT32  pos1, DocColour *  pColour2, INT32  pos2, INT32  bias, EFFECTTYPE  effect )  [private]

Writes the additional entries required for a special fill effect (rainbow or alt-rainbow) to the gradient definition, as a series of steps. See Also: AIEPSRenderRegion::WriteGradientEntry AIEPSRenderRegion::WriteLinearFill AIEPSRenderRegion::WriteRadialFill. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 4/4/2001 Parameters: pColour1  - The colour to start from. [INPUTS] pos1 - The position of the start colour within the fill (0-100%). pColour2 - The colour to end at. pos2 - The position of the end colour within the entire fill (0-100%) bias - The fill's bias part of any profile (0-100%). effect - The type of fill effect (EFFECT_HSV_SHORT or EFFECT_HSV_LONG) Returns: TRUE if successful. FALSE if error (e.g. file/disk error) Definition at line 1077 of file ai_epsrr.cpp. { ERROR3IF (effect == EFFECT_RGB, "AIEPSRenderRegion::WriteFillEffectSteps, an attempt was made to write HSV fill effect steps on an RGB fade fill"); // RGB fades are the 'standard' fill, so we don't want to do any special processing on them if (effect != EFFECT_RGB) { // Start and end colour values INT32 h1 = 0; INT32 h2 = 0; INT32 s1 = 0; INT32 s2 = 0; INT32 v1 = 0; INT32 v2 = 0; // intermediate colour values / increments DocColour midColour; double hAdd = 0; double sAdd = 0; double vAdd = 0; double posAdd = 0; // First get the start and end colour components pColour1->GetHSVValue (&h1, &s1, &v1); pColour2->GetHSVValue (&h2, &s2, &v2); // Calculate the increments // // NOTE: if the hue changes by more than 180 deg. in a short HSV (rainbow) fill // (or not more than 180 deg. in a long HSV (alt-rainbow) fill), then the direction // must be reversed. This is done by changing the hue increment value. hAdd = h2-h1; if (effect == EFFECT_HSV_SHORT) { if (hAdd > 180) hAdd -= 360; else if (hAdd < -180) hAdd += 360; } else { if ((hAdd > 0) && (hAdd <= 180)) hAdd -= 360; else if ((hAdd <= 0) && (hAdd >= -180)) hAdd += 360; } hAdd = hAdd / (NumFillEmulationSteps + 1); sAdd = (s2-s1) / (NumFillEmulationSteps + 1); vAdd = (v2-v1) / (NumFillEmulationSteps + 1); posAdd = ((double) pos2-pos1) / (NumFillEmulationSteps + 1); // Cycle through the stops calcuating each stop's colour and position, before // writing them out. for (INT32 i=1; i<NumFillEmulationSteps + 1; i++) { // increment each colour value and the position h2 = (INT32)(h1 + (i * hAdd)); s2 = (INT32)(s1 + (i * sAdd)); v2 = (INT32)(v1 + (i * vAdd)); pos2 = (INT32)(pos1 + (i * posAdd)); // wrap the hue around if it's gone past 360 deg or 0 deg. if (h2>=360) h2 -= 360; else if (h2<0) h2 += 360; // create the colour and export. midColour.SetHSVValue (h2, s2, v2); WriteGradientEntry (&midColour, pos2, 50); } } // End of is fill effect not an RGB fade. return TRUE; }

void AIEPSRenderRegion::WriteGradientCount (   )  [private, virtual]

Writes out the count of all the gradient fills in the Cache. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 20/3/2001 See also: AIEPSRenderRegion::WriteGradientDefinitions, AIEPSRenderRegion::BuildGradientCache Definition at line 3664 of file ai_epsrr.cpp. { KernelDC *pDC = (KernelDC*)CCDC::ConvertFromNativeDC(RenderDC); ListFill * pList = m_pLinearGradList; INT32 numFills = 0; // Cycle through the gradient cache writing out fills as we go. // // First count the linear fills while (pList != NULL) { numFills ++; pList = pList->pNext; } // Then count the radial fills. pList = m_pRadialGradList; while (pList != NULL) { numFills ++; pList = pList->pNext; } // If there are any fills, then write the count out. if (numFills) { pDC->OutputValue (numFills); pDC->OutputToken (_T("Bn")); pDC->OutputNewLine (); } }

void AIEPSRenderRegion::WriteGradientDefinitions (   )  [private, virtual]

Writes out the definitions of all the gradient fills in the Cache. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 5/2/2001 See also: AIEPSRenderRegion::WriteGradientCount, AIEPSRenderRegion::BuildGradientCache Definition at line 3708 of file ai_epsrr.cpp. { ListFill * pList = NULL; FillGeometryAttribute * pFill = NULL; // Cycle through the gradient cache writing out fills as we go. // // First do the linear list. pList = m_pLinearGradList; while (pList != NULL) { pFill = pList->pFill; WriteLinearFill ( pFill, pList->effect, pList->id ); pList = pList->pNext; } // Then do the radial list. pList = m_pRadialGradList; while (pList != NULL) { pFill = pList->pFill; WriteRadialFill ( pFill, pList->effect, pList->id ); pList = pList->pNext; } }

BOOL AIEPSRenderRegion::WriteGradientEntry (  DocColour *  pColour, INT32  Position, INT32  Midpoint )  [private]

Writes a line into the definition of a gradient fill. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 24/3/00 Parameters: pColour  - A pointer to a Camelot colour. [INPUTS] Position - The position of the colour within the fill. Midpoint - The midpoint of the fill. Returns: TRUE if successful. FALSE if error (e.g. file/disk error) Definition at line 1002 of file ai_epsrr.cpp. { INT32 red; // INT32 green; // RGB colour values INT32 blue; // PColourCMYK CMYKColour; // The colour to be stored. KernelDC *pDC = (KernelDC*)CCDC::ConvertFromNativeDC(RenderDC); TCHAR Line [80]; // Contains the string to be stored. // (ChrisG 3/4/2001) if (Midpoint < 13) Midpoint = 13; else if (Midpoint > 87) Midpoint = 87; pColour->GetCMYKValue ( &CMYKColour ); // Extract the CMYK value. if (pColour->GetColourModel () == COLOURMODEL_RGBT || pColour->GetColourModel () == COLOURMODEL_HSVT) { // Use RGB syntax. pColour->GetRGBValue ( &red, &green, &blue ); camSprintf ( Line, _T("2 %d %d%%_Bs"), Midpoint, Position ); pDC->OutputColour ( &CMYKColour ); pDC->OutputColourValue ( red ); pDC->OutputColourValue ( green ); pDC->OutputColourValue ( blue ); pDC->OutputToken ( Line ); pDC->OutputNewLine (); } else { // It is necessary to build the output line like this, so that there isn't a space // between the position of the colour, and the %_Bs operator. camSprintf ( Line, _T("1 %d %d%%_Bs"), Midpoint, Position ); // Build the output string. pDC->OutputColour ( &CMYKColour ); // Write the colour to the file. pDC->OutputToken ( Line ); // Write the output string out. pDC->OutputNewLine (); // And write a new-line tag. } return TRUE; // All done successfully. }

void AIEPSRenderRegion::WriteGradientFillInstance (   )  [private, virtual]

This function identifies whether or not the current fill is a gradient fill, and writes in the appropriate values if it is. I've already created the records of the gradients themselves (see above), so this is just a case of matching the gradient with its ID, and Adobe Illustrator can then put the records together. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 9/03/00 (ChrisG 18/12/00) - all this does now is increment the counters used for determining which gradient fill is currently being used. See also: EPSRenderRegion::WriteGradientFill, WriteGradientFillUsage Reimplemented from EPSRenderRegion. Definition at line 1259 of file ai_epsrr.cpp. { KernelDC *pDC = (KernelDC*)CCDC::ConvertFromNativeDC(RenderDC); FillGeometryAttribute *pFillAttr = ( FillGeometryAttribute* ) CurrentAttrs[ATTR_FILLGEOMETRY].pAttr; DocCoord StartPoint = *( pFillAttr->GetStartPoint () ); DocCoord EndPoint = *( pFillAttr->GetEndPoint () ); DocCoord Delta = EndPoint - StartPoint; double Angle = 90.0f; double Length = FlashExportDC::CalculateLength ( Delta ); TCHAR Name [80]; BOOL IsRadial = pFillAttr->IsARadialFill () || pFillAttr->IsASquareFill (); INT32 id = 0; if (IsGradientFillValidForExport (pFillAttr)) { id = FindGradientInCache (pFillAttr, GetFillEffect ()); // If the fill is, or can be approximated by, a radial fill, set the the definition to // indicate this. if ( IsRadial ) { // Set up the name to show that it's a radial gradient. camSprintf ( Name, _T("(%s %d)"), RadialGradient, id ); } // Otherwise it's represented by a linear fill. else { // Set up the name to show that it's a linear gradient. camSprintf ( Name, _T("(%s %d)"), LinearGradient, id ); // Reset the end point value if we're dealing with a three colour fill. if ( pFillAttr->IsAThreeColFill () ) { DocCoord EndPoint2 = *( pFillAttr->GetEndPoint2 () ); // Complete the parallellogram of vectors. EndPoint += EndPoint2 - StartPoint; } } // (ChrisG 16/01/01) Since all the endpoint calculations have now been done, // we can determine Delta, length and angle. (NOTE: these cannot be done // before here, as we wouldn't be using the correct endpoint values.) Delta = EndPoint - StartPoint; Length = FlashExportDC::CalculateLength ( Delta ); // The tangent of an angle is undefined for PI/2 radians. (i.e. when Delta.x // is zero.) if ( Delta.x != 0 ) { Angle = atan ( ( double ) Delta.y / ( double ) Delta.x ); // AI uses degrees, whereas the standard maths library uses radians, so // effect a conversion. Angle *= ( 180.0 / PI ); // Pi radians = 180 degrees. // Tan repeats itself every Pi radians, so add 180 degrees to the angle // if it's got a negative value of Delta.y. Special case: If Delta.x is // negative, and Delta.y is 0, the angle is 180 degrees. if ( Delta.x < 0 ) { // I want the angle to be in the interval ]-180, 180], and so I've // got special case handling, depending on which quadrant it lies // in initially. Without the if statement here, the interval would // be ]-90, 270]. if ( Angle >= 0.0 ) { Angle -= 180.0; } else { Angle += 180.0; } } } // More special case stuff. If Delta.x is 0, then the angle must be either // +90 or -90 degrees. And we can get the sign of the angle from the sign // of Delta.y else if ( Delta.y < 0 ) { Angle = -90.0; } // AI uses points as a co-ordinate system - we use millipoints. Dividing // the length of the fill by 1,000 will thus return it's value in points. Length /= 1000; // Write out the appropriate fill record. pDC->OutputToken ( _T("1") ); // It is a clipped gradient. pDC->OutputToken ( Name ); // The gradient's name. pDC->OutputCoord ( StartPoint ); // Start point for the gradient fill. pDC->OutputReal ( Angle ); // The angle of the fill from the X-Axis. pDC->OutputReal ( Length ); // The length of the matrix. pDC->OutputToken ( _T("1 0 0 1 0 0 Bg") ); // Matrix manipulating the fill. (Unused.) pDC->OutputNewLine (); } // End of IsGradientFillValidForExport. }

BOOL AIEPSRenderRegion::WriteGradientFills (  Document *  pDocument  )  [protected, virtual]

Parses through the tree, identifies any gradient fills, and writes them to the export DC's file. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 1/3/00 Parameters: pDocument  - The document to be written. [INPUTS] -  [OUTPUTS] Returns: TRUE if successful. FALSE if error (e.g. file/disk error) Reimplemented from EPSRenderRegion. Definition at line 675 of file ai_epsrr.cpp. { // Get the spread from the document. Spread *pSpread = pDocument->FindFirstSpread (); // Build the gradient cache up from all the fills under the spread, after cleaning any // junk out of it (there shouldn't be any there, but that ain't the point) ClearGradientCache (); BuildGradientCache (pSpread); // Write out the number of fills and their definition. WriteGradientCount (); WriteGradientDefinitions (); // The fill has been successfully saved, so return TRUE. return TRUE; }

BOOL AIEPSRenderRegion::WriteLinearFill (  FillGeometryAttribute *  pFill, EFFECTTYPE  effect, INT32  id )  [private]

Writes a linear fill to the disk file. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 1/3/00 Parameters: pFill  - A pointer to the fill attribute record. [INPUTS] id - the id number for the fill Returns: TRUE - If successful. FALSE - The was an error (e.g. file/disk error). Definition at line 707 of file ai_epsrr.cpp. { // Extract the fill attribute - this is necessary for processing the fill type. KernelDC *pDC = static_cast<KernelDC *> ( CCDC::ConvertFromNativeDC(RenderDC) ); INT32 Colours = 2; TCHAR GradientName [32]; DocColour StartColour = *( pFill->GetStartColour () ); DocColour EndColour; ColourRamp *pRamp = pFill->GetColourRamp (); // The fill is, or can be approximated by, a linear fill. camSprintf ( GradientName, _T("(%s %d)"), LinearGradient, id ); // (ChrisG 16/01/01) Four colour fill MUST come first, as it's derived from Three // colour fill, and returns valid for IsThreeColFill(). if ( pFill->IsAFourColFill () ) { // I'm going to use a version of the below here, but for now I'll just // set up the end colour as the most distant end colour. EndColour = *( pFill->GetEndColour3 () ); } else if ( pFill->IsAThreeColFill () ) { // AI doesn't support three colour fills, so I'm going to fake it. This // code merges the two end colours to approximate the fill with a two // colour linear fill. EndColour.Mix ( pFill->GetEndColour (), pFill->GetEndColour2(), 0.5f, NULL, FALSE, NULL ); } else { // Set up the end colour value appropriately. EndColour = *( pFill->GetEndColour () ); } // Count the number of colours. if ( pRamp != NULL ) { UINT32 First = 0; UINT32 Last = 0; // Extract the indices from the colour ramp. pRamp->GetIndexRange ( &First, &Last ); // And add their difference to the colour count. Note, you need to add one // to the result so that you don't register having no colours. There really // should be a count number of elements method in the ramp code, though. Colours += 1 + Last - First; } // (ChrisG 15/01/01) If this is a four colour fill, since we will be adding a mid-colour // below, then we need to include it in the definition if (pFill->IsAFourColFill ()) { Colours ++; } // (ChrisG 4/4/2001) Add in the extra colours given from the HSV fill effect emulation if (effect == EFFECT_HSV_SHORT || effect == EFFECT_HSV_LONG) { Colours += (Colours - 1) * NumFillEmulationSteps; } // Write the gradient's header. pDC->OutputToken ( _T("%AI5_BeginGradient:") ); pDC->OutputToken ( GradientName ); pDC->OutputNewLine (); // Then the type definition. pDC->OutputToken ( GradientName ); pDC->OutputValue ( static_cast<INT32> ( LinearFill ) ); pDC->OutputValue ( static_cast<INT32> ( Colours ) ); pDC->OutputToken ( _T("Bd") ); pDC->OutputNewLine (); pDC->OutputToken ( _T("[") ); pDC->OutputNewLine (); // (ChrisG 3/4/2001) Get bias and convert to 0-100 range (from -1 to +1) // This will be used later on to offset the positions CProfileBiasGain profile = pFill->GetProfile (); INT32 bias = (INT32) ((1 - (double) profile.GetBias ()) * 50); // Write out the last colour. WriteGradientEntry ( &EndColour, 100, 50 ); // set up the last colour and position (for the fill effect emulation. DocColour * pLastColour = &EndColour; INT32 lastPos = 100; // Mid colour for four colour fills - this needs to be stored longer so that it can be // re-used in the case of HSV fill effects. DocColour MidColour; // If the fill is a four colour fill, add a mid-colour that's a blend of the // second and third colours. if ( pFill->IsAFourColFill () ) { MidColour.Mix ( pFill->GetEndColour (), pFill->GetEndColour2 (), 0.5f, NULL, FALSE, NULL ); // Write out the extra fill steps, if there are any. if (effect != EFFECT_RGB) { WriteFillEffectSteps (pLastColour, lastPos, &MidColour, 50, bias, effect); pLastColour = &MidColour; } // And set the value. WriteGradientEntry ( &MidColour, 50, bias); } // Otherwise, process the colour ramp. else if ( pRamp != NULL ) { ColRampItem *pItem = pRamp->GetLastCol (); // Write in the ramp's colour values. while ( pItem != NULL ) { // Get the position of the colour in the fill. INT32 Ratio = static_cast <INT32> ( 100 * pItem->GetPosition () ); DocColour *pCol = pItem->GetColourAddr (); // Write out the extra fill steps, if there are any. if (effect != EFFECT_RGB) { WriteFillEffectSteps (pLastColour, lastPos, pCol, Ratio, bias, effect); pLastColour = pCol; lastPos = Ratio; } // And set the value. WriteGradientEntry ( pCol, Ratio, 50 ); // Increment the pointer onto the next item. pItem = pRamp->GetPrevCol ( pItem ); } } // Write out the extra fill steps, if there are any. if (effect != EFFECT_RGB) { WriteFillEffectSteps (pLastColour, lastPos, &StartColour, 0, bias, effect); } // Write out the start colour. WriteGradientEntry ( &StartColour, 0, bias ); // Write out the end of gradient tokens. pDC->OutputToken ( _T("BD") ); pDC->OutputNewLine (); pDC->OutputToken ( _T("%AI5_EndGradient") ); pDC->OutputNewLine (); // It worked! return TRUE; }

BOOL AIEPSRenderRegion::WriteLoadedMatrix (  void   )  [private]

Writes a pre-loaded matrix to the file. I've added a couple of functions to create a matrix first, since it'll be more efficient to store the data, and re-write it as required, than to recalculate it twice. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 10/4/00 Parameters: -  [INPUTS] Returns: TRUE - Success. FALSE - An error occured. See also: AIESPRenderRegion::LoadBitmapMatrix, AIEPSRenderRegion::LoadTranslationMatrix Definition at line 1554 of file ai_epsrr.cpp. { // Cast the DC pointer to be a KernelDC pointer. This allows it to access useful member // functions. KernelDC *pDC = static_cast<KernelDC *> ( CCDC::ConvertFromNativeDC(RenderDC) ); // Write the matrix. pDC->OutputToken ( _T("[") ); pDC->OutputReal ( m_a ); pDC->OutputReal ( m_b ); pDC->OutputReal ( m_c ); pDC->OutputReal ( m_d ); pDC->OutputCoord ( m_T ); pDC->OutputToken ( _T("]") ); return TRUE; }

BOOL AIEPSRenderRegion::WriteMask (  Path *  MaskPath, BOOL  OutputGroupToken = FALSE )

Creates a path that defines a masking pattern. All successive paths (until the end of mask operator) will be clipped to this shape. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 7/4/00 Parameters: DrawPath  - The path to render. [INPUTS] OutputGroupToken whether or not we output a 'q' clipping group token. I've repeated a lot of code from EPSRenderRegion::ExportPath because I'm scared of changing what is a fairly fundamental class, and then finding that there are several hundred resultant problems. A lot of the filters are pretty shakey at the moment in any case. See also: RenderRegion::ExportPath Definition at line 1591 of file ai_epsrr.cpp. { KernelDC *pDC = static_cast<KernelDC*> ( CCDC::ConvertFromNativeDC(RenderDC) ); // DC for export file. DocCoord *Coords = MaskPath->GetCoordArray(); PathVerb *Verbs = MaskPath->GetVerbArray(); INT32 NumCoords = MaskPath->GetNumCoords(); INT32 ReadPos = 1; // Reading data from. BOOL IsCompound = FALSE; // (ChrisG 16/01/01) Only write masks/clips if there is a path to clip to. if (NumCoords != 0) { if (OutputGroupToken) { // Start the mask. pDC->OutputToken ( _T("q") ); pDC->OutputNewLine (); } // Check to see if this is a compound path. If it is, there will be more than one // moveto command. while ( ReadPos < NumCoords ) { // Find out the type of element that we are over, after the close flag has been // removed. if ( ( ( Verbs [ReadPos] ) & ( ~PT_CLOSEFIGURE ) ) == PT_MOVETO ) { // This is a compound path - stop searching for moveto's. IsCompound = TRUE; // Write the tag to indicate that it's a compound path. pDC->OutputToken ( _T("*u") ); pDC->OutputNewLine (); break; } else { // Try next point ReadPos++; } } // Reset to start of path ReadPos = 0; // loop through the whole path while(ReadPos < NumCoords) { // Find out the type of element that we are over (after the close flag has been removed) // Coord P[4]; switch ( (Verbs[ReadPos]) & (~PT_CLOSEFIGURE) ) { case PT_MOVETO: // If this is in the middle of the path, specify how this sub-path // should be rendered - this is needed so that we re-import all the flags // correctly on complex paths (e.g. PT_CLOSEFIGURE) if (ReadPos > 0) { // Write out the mask definition. WriteMaskTags (); } // Output the moveto command pDC->OutputCoord(Coords[ReadPos]); pDC->OutputToken(TEXT("m")); pDC->OutputNewLine(); ReadPos++; break; case PT_LINETO: // Output the lineto command pDC->OutputCoord(Coords[ReadPos]); pDC->OutputToken(TEXT("l")); pDC->OutputNewLine(); ReadPos++; break; case PT_BEZIERTO: // If this point is a bezier, then the next 2 points should be beziers to ENSURE((Verbs[ReadPos+1]) & (~PT_CLOSEFIGURE), "Bezier found with 1 point"); ENSURE((Verbs[ReadPos+2]) & (~PT_CLOSEFIGURE), "Bezier found with 2 points"); // Make sure that this is not at the start of the path ENSURE(ReadPos > 0, "Broken path found while exporting EPS" ); // Output the moveto command pDC->OutputCoord(Coords[ReadPos]); pDC->OutputCoord(Coords[ReadPos+1]); pDC->OutputCoord(Coords[ReadPos+2]); pDC->OutputToken(TEXT("c")); pDC->OutputNewLine(); ReadPos += 3; break; default: ENSURE( FALSE, "We found a Path Element that does not exist!" ); break; } } // Do the final (or possibly only) render command WriteMaskTags (); if ( IsCompound ) { // End compound path pDC->OutputToken(_T("*U")); pDC->OutputNewLine(); } // Wrap up the mask. pDC->OutputToken ( _T("0 O") ); pDC->OutputNewLine (); } // End of if there is a clip path. return TRUE; }

BOOL AIEPSRenderRegion::WriteMaskTags (  void   )  [private]

Writes out the tags at the end of each block of a mask's definition. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 11/4/00 Returns: TRUE - Success. FALSE - Error. See also: RenderRegion::ExportPath Definition at line 1726 of file ai_epsrr.cpp. { KernelDC *pDC = static_cast<KernelDC*> ( CCDC::ConvertFromNativeDC(RenderDC) ); // DC for export file. // Write out the mask definition tags. pDC->OutputToken ( _T("h") ); pDC->OutputNewLine (); pDC->OutputToken ( _T("W") ); pDC->OutputNewLine (); pDC->OutputToken ( _T("n") ); pDC->OutputNewLine (); return TRUE; }

BOOL AIEPSRenderRegion::WriteNewLine (  void   )  [protected, virtual]

Writes a new line to the output of text if text is exported as characters, does nothing if it's exported as shapes. Author: Chris_Gallimore (Xara Group Ltd) <camelotdev@xara.com> Date: 9th November 2000 Returns: BOOL - whether the a new line was written successfully. See also: EPSRenderRegion::WriteNewLine Reimplemented from EPSRenderRegion. Definition at line 3057 of file ai_epsrr.cpp. { BOOL success; // don't write any newlines if we're exporting text as shapes (cos' it could stuff up // the eps). if (GetTextAsShapes () == TRUE) { success = TRUE; } else { success = EPSRenderRegion::WriteNewLine (); } return success; }

BOOL AIEPSRenderRegion::WriteRadialFill (  FillGeometryAttribute *  pFill, EFFECTTYPE  effect, INT32  id )  [private]

Writes a Radial fill to the disk file. Author: Graeme_Sutherland (Xara Group Ltd) <camelotdev@xara.com> Date: 1/3/00 Parameters: pFill  - A pointer to the fill attribute record. [INPUTS] id - The fill's id number Returns: TRUE - If successful. FALSE - The was an error (e.g. file/disk error). Definition at line 880 of file ai_epsrr.cpp. { // Extract the fill attribute - this is necessary for processing the fill type. KernelDC *pDC = static_cast<KernelDC *> ( CCDC::ConvertFromNativeDC(RenderDC) ); INT32 Colours = 2; TCHAR GradientName [32]; DocColour StartColour = *( pFill->GetStartColour () ); DocColour EndColour = *( pFill->GetEndColour () ); ColourRamp *pRamp = pFill->GetColourRamp (); // The fill is, or can be approximated by, a Radial fill. camSprintf ( GradientName, _T("(%s %d)"), RadialGradient, id ); // Count the number of colours. if ( pRamp != NULL ) { UINT32 First = 0; UINT32 Last = 0; // Extract the indices from the colour ramp. pRamp->GetIndexRange ( &First, &Last ); // And add their difference to the colour count. Note, you need to add one // to the result so that you don't register having no colours. There really // should be a count number of elements method in the ramp code, though. Colours += 1 + Last - First; if (effect != EFFECT_RGB) { // Add in the extra steps for the fill effect (Five extra steps between each // pair of colours). Colours += (Colours - 1) * NumFillEmulationSteps; } } // Write the gradient's header. pDC->OutputToken ( _T("%AI5_BeginGradient:") ); pDC->OutputToken ( GradientName ); pDC->OutputNewLine (); // Then the type definition. pDC->OutputToken ( GradientName ); pDC->OutputValue ( static_cast<INT32> ( RadialFill ) ); pDC->OutputValue ( static_cast<INT32> ( Colours ) ); pDC->OutputToken ( _T("Bd") ); pDC->OutputNewLine (); pDC->OutputToken ( _T("[") ); pDC->OutputNewLine (); // (ChrisG 3/4/2001) Get bias and convert to 0-100 range (from -1 to +1) CProfileBiasGain profile = pFill->GetProfile (); INT32 bias = (INT32) ((1 - (double) profile.GetBias ()) * 50); // Write out the start colour. WriteGradientEntry ( &StartColour, 0, bias ); DocColour * pLastCol = &StartColour; INT32 lastPos = 0; // Process the colour ramp. if ( pRamp != NULL ) { ColRampItem *pItem = pRamp->GetFirstCol (); // Write in the ramp's colour values. while ( pItem != NULL ) { // Get the position of the colour in the fill. INT32 Ratio = static_cast <INT32> ( 100 * pItem->GetPosition () ); DocColour *pCol = pItem->GetColourAddr (); // Write out the intermediate fill steps (if there are any). if (effect != EFFECT_RGB) { WriteFillEffectSteps (pLastCol, lastPos, pCol, Ratio, bias, effect); pLastCol = pCol; lastPos = Ratio; } // And set the value. WriteGradientEntry ( pCol, Ratio, 50 ); // Increment the pointer onto the next item. pItem = pRamp->GetNextCol ( pItem ); } } // Write out the intermediate fill steps (if there are any). if (effect != EFFECT_RGB) { WriteFillEffectSteps (pLastCol, lastPos, &EndColour, 100, bias, effect); } // Write out the last colour. WriteGradientEntry ( &EndColour, 100, 50 ); // Write out the end of gradient tokens. pDC->OutputToken ( _T("BD") ); pDC->OutputNewLine (); pDC->OutputToken ( _T("%AI5_EndGradient") ); pDC->OutputNewLine (); // It worked! return TRUE; }

---

Friends And Related Function Documentation

friend class AIEPSGradientScanRenderRegion [friend]

Definition at line 209 of file ai_epsrr.h.

---

Member Data Documentation

double AIEPSRenderRegion::m_a [private]

Definition at line 360 of file ai_epsrr.h.

BOOL AIEPSRenderRegion::m_ActiveLayer [private]

Definition at line 366 of file ai_epsrr.h.

double AIEPSRenderRegion::m_b [private]

Definition at line 361 of file ai_epsrr.h.

BOOL AIEPSRenderRegion::m_bInTextGap [private]

Definition at line 370 of file ai_epsrr.h.

BOOL AIEPSRenderRegion::m_bTextAsShapes [private]

Definition at line 371 of file ai_epsrr.h.

double AIEPSRenderRegion::m_c [private]

Definition at line 362 of file ai_epsrr.h.

double AIEPSRenderRegion::m_d [private]

Definition at line 363 of file ai_epsrr.h.

FILE* AIEPSRenderRegion::m_fpOverflowText [private]

Definition at line 369 of file ai_epsrr.h.

UINT32 AIEPSRenderRegion::m_LayerColour [private]

Definition at line 367 of file ai_epsrr.h.

ListFill* AIEPSRenderRegion::m_pLinearGradList [private]

Definition at line 357 of file ai_epsrr.h.

ListFill* AIEPSRenderRegion::m_pRadialGradList [private]

Definition at line 358 of file ai_epsrr.h.

DocCoord AIEPSRenderRegion::m_T [private]

Definition at line 364 of file ai_epsrr.h.

---

The documentation for this class was generated from the following files:

• Kernel/ai_epsrr.h (r1785/r1336)
• Kernel/ai_epsrr.cpp (r1785/r1336)

---