?  search:
summary | log | graphiclog1 | graphiclog2 | commit | commitdiff | tree | refs | edit | fork
blame | history | raw | HEAD
Version 4.3.0.0.beta1, tag libreoffice-4.3.0.0.beta1
[LibreOffice.git] / include / vcl / outdev.hxx
blob0c185253e461338b998c0d58a72f562082d78fe5
1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
2 /*
3 * This file is part of the LibreOffice project.
4 *
5 * This Source Code Form is subject to the terms of the Mozilla Public
6 * License, v. 2.0. If a copy of the MPL was not distributed with this
7 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
8 *
9 * This file incorporates work covered by the following license notice:
10 *
11 * Licensed to the Apache Software Foundation (ASF) under one or more
12 * contributor license agreements. See the NOTICE file distributed
13 * with this work for additional information regarding copyright
14 * ownership. The ASF licenses this file to you under the Apache
15 * License, Version 2.0 (the "License"); you may not use this file
16 * except in compliance with the License. You may obtain a copy of
17 * the License at http://www.apache.org/licenses/LICENSE-2.0 .
18 */
19
20 #ifndef INCLUDED_VCL_OUTDEV_HXX
21 #define INCLUDED_VCL_OUTDEV_HXX
22
23 #include <tools/gen.hxx>
24 #include <tools/solar.h>
25 #include <tools/rc.hxx>
26 #include <tools/color.hxx>
27 #include <tools/poly.hxx>
28
29 #include <vcl/dllapi.h>
30 #include <vcl/font.hxx>
31 #include <vcl/region.hxx>
32 #include <vcl/mapmod.hxx>
33 #include <vcl/wall.hxx>
34 #include <vcl/metaact.hxx>
35 #include <vcl/salnativewidgets.hxx>
36 #include <vcl/outdevstate.hxx>
37 #include <vcl/outdevmap.hxx>
38
39 #include <basegfx/vector/b2enums.hxx>
40 #include <basegfx/polygon/b2dpolypolygon.hxx>
41
42 #include <unotools/fontdefs.hxx>
43
44 #include <boost/scoped_ptr.hpp>
45 #ifdef check
46 # //some problem with MacOSX and a check define
47 # undef check
48 #endif
49 #include <boost/ptr_container/ptr_deque.hpp>
50
51 #include <com/sun/star/drawing/LineCap.hpp>
52 #include <com/sun/star/uno/Reference.h>
53
54 #include <vector>
55 #include <stack>
56
57 #if defined UNX
58 #define GLYPH_FONT_HEIGHT 128
59 #else
60 #define GLYPH_FONT_HEIGHT 256
61 #endif
62
63 #define META_BMPSCALEPART_ACTION (118)
64 #define META_BMPEXSCALEPART_ACTION (121)
65
66 struct ImplOutDevData;
67 class ImplFontEntry;
68 class OutDevState;
69 struct SystemGraphicsData;
70 struct SystemFontData;
71 struct SystemTextLayoutData;
72 class ImplFontCache;
73 class PhysicalFontCollection;
74 class ImplGetDevFontList;
75 class ImplGetDevSizeList;
76 class ImplMultiTextLineInfo;
77 class SalGraphics;
78 class Gradient;
79 class Hatch;
80 class AllSettings;
81 class Bitmap;
82 class BitmapReadAccess;
83 class BitmapEx;
84 class Image;
85 class TextRectInfo;
86 class FontInfo;
87 class FontMetric;
88 class GDIMetaFile;
89 class GfxLink;
90 class Line;
91 class LineInfo;
92 class AlphaMask;
93 class FontCharMap;
94 class SalLayout;
95 class ImplLayoutArgs;
96 class ImplFontAttributes;
97 class VirtualDevice;
98 class Window;
99 struct SalTwoRect;
100
101 namespace com {
102 namespace sun {
103 namespace star {
104 namespace rendering {
105 class XCanvas;
106 }}}}
107 namespace basegfx {
108 class B2DHomMatrix;
109 class B2DPolygon;
110 class B2DPolyPolygon;
111 }
112
113 namespace com {
114 namespace sun {
115 namespace star {
116 namespace awt {
117 class XGraphics;
118 } } } }
119
120 typedef std::vector< Rectangle > MetricVector;
121
122 namespace vcl
123 {
124 class PDFWriterImpl;
125 class ExtOutDevData;
126 class ITextLayout;
127 struct FontCapabilities;
128 }
129
130 // OutputDevice-Types
131
132 // Flags for DrawText()
133 #define TEXT_DRAW_DISABLE ((sal_uInt16)0x0001)
134 #define TEXT_DRAW_MNEMONIC ((sal_uInt16)0x0002)
135 #define TEXT_DRAW_MONO ((sal_uInt16)0x0004)
136 #define TEXT_DRAW_CLIP ((sal_uInt16)0x0008)
137 #define TEXT_DRAW_LEFT ((sal_uInt16)0x0010)
138 #define TEXT_DRAW_CENTER ((sal_uInt16)0x0020)
139 #define TEXT_DRAW_RIGHT ((sal_uInt16)0x0040)
140 #define TEXT_DRAW_TOP ((sal_uInt16)0x0080)
141 #define TEXT_DRAW_VCENTER ((sal_uInt16)0x0100)
142 #define TEXT_DRAW_BOTTOM ((sal_uInt16)0x0200)
143 #define TEXT_DRAW_ENDELLIPSIS ((sal_uInt16)0x0400)
144 #define TEXT_DRAW_PATHELLIPSIS ((sal_uInt16)0x0800)
145 #define TEXT_DRAW_MULTILINE ((sal_uInt16)0x1000)
146 #define TEXT_DRAW_WORDBREAK ((sal_uInt16)0x2000)
147 #define TEXT_DRAW_NEWSELLIPSIS ((sal_uInt16)0x4000)
148 // in the long run we should make text style flags longer
149 // but at the moment we can get away with this 2 bit field for ellipsis style
150 #define TEXT_DRAW_CENTERELLIPSIS (TEXT_DRAW_ENDELLIPSIS | TEXT_DRAW_PATHELLIPSIS)
151
152 #define TEXT_DRAW_WORDBREAK_HYPHENATION (((sal_uInt16)0x8000) | TEXT_DRAW_WORDBREAK)
153
154 // Flags for CopyArea()
155 #define COPYAREA_WINDOWINVALIDATE ((sal_uInt16)0x0001)
156
157 // Flags for DrawImage()
158 #define IMAGE_DRAW_DISABLE ((sal_uInt16)0x0001)
159 #define IMAGE_DRAW_HIGHLIGHT ((sal_uInt16)0x0002)
160 #define IMAGE_DRAW_DEACTIVE ((sal_uInt16)0x0004)
161 #define IMAGE_DRAW_COLORTRANSFORM ((sal_uInt16)0x0008)
162 #define IMAGE_DRAW_SEMITRANSPARENT ((sal_uInt16)0x0010)
163
164 // Grid
165 #define GRID_DOTS ((sal_uLong)0x00000001)
166 #define GRID_HORZLINES ((sal_uLong)0x00000002)
167 #define GRID_VERTLINES ((sal_uLong)0x00000004)
168 #define GRID_LINES (GRID_HORZLINES | GRID_VERTLINES)
169
170 // LayoutModes for Complex Text Layout
171 #define TEXT_LAYOUT_DEFAULT ((sal_uLong)0x00000000)
172 #define TEXT_LAYOUT_BIDI_LTR ((sal_uLong)0x00000000)
173 #define TEXT_LAYOUT_BIDI_RTL ((sal_uLong)0x00000001)
174 #define TEXT_LAYOUT_BIDI_STRONG ((sal_uLong)0x00000002)
175 #define TEXT_LAYOUT_TEXTORIGIN_LEFT ((sal_uLong)0x00000004)
176 #define TEXT_LAYOUT_TEXTORIGIN_RIGHT ((sal_uLong)0x00000008)
177 #define TEXT_LAYOUT_COMPLEX_DISABLED ((sal_uLong)0x00000100)
178 #define TEXT_LAYOUT_ENABLE_LIGATURES ((sal_uLong)0x00000200)
179 #define TEXT_LAYOUT_SUBSTITUTE_DIGITS ((sal_uLong)0x00000400)
180
181 // DrawModes
182 #define DRAWMODE_DEFAULT ((sal_uLong)0x00000000)
183 #define DRAWMODE_BLACKLINE ((sal_uLong)0x00000001)
184 #define DRAWMODE_BLACKFILL ((sal_uLong)0x00000002)
185 #define DRAWMODE_BLACKTEXT ((sal_uLong)0x00000004)
186 #define DRAWMODE_BLACKBITMAP ((sal_uLong)0x00000008)
187 #define DRAWMODE_BLACKGRADIENT ((sal_uLong)0x00000010)
188 #define DRAWMODE_GRAYLINE ((sal_uLong)0x00000020)
189 #define DRAWMODE_GRAYFILL ((sal_uLong)0x00000040)
190 #define DRAWMODE_GRAYTEXT ((sal_uLong)0x00000080)
191 #define DRAWMODE_GRAYBITMAP ((sal_uLong)0x00000100)
192 #define DRAWMODE_GRAYGRADIENT ((sal_uLong)0x00000200)
193 #define DRAWMODE_NOFILL ((sal_uLong)0x00000400)
194 #define DRAWMODE_NOBITMAP ((sal_uLong)0x00000800)
195 #define DRAWMODE_NOGRADIENT ((sal_uLong)0x00001000)
196 #define DRAWMODE_GHOSTEDLINE ((sal_uLong)0x00002000)
197 #define DRAWMODE_GHOSTEDFILL ((sal_uLong)0x00004000)
198 #define DRAWMODE_GHOSTEDTEXT ((sal_uLong)0x00008000)
199 #define DRAWMODE_GHOSTEDBITMAP ((sal_uLong)0x00010000)
200 #define DRAWMODE_GHOSTEDGRADIENT ((sal_uLong)0x00020000)
201 #define DRAWMODE_WHITELINE ((sal_uLong)0x00100000)
202 #define DRAWMODE_WHITEFILL ((sal_uLong)0x00200000)
203 #define DRAWMODE_WHITETEXT ((sal_uLong)0x00400000)
204 #define DRAWMODE_WHITEBITMAP ((sal_uLong)0x00800000)
205 #define DRAWMODE_WHITEGRADIENT ((sal_uLong)0x01000000)
206 #define DRAWMODE_SETTINGSLINE ((sal_uLong)0x02000000)
207 #define DRAWMODE_SETTINGSFILL ((sal_uLong)0x04000000)
208 #define DRAWMODE_SETTINGSTEXT ((sal_uLong)0x08000000)
209 #define DRAWMODE_SETTINGSGRADIENT ((sal_uLong)0x10000000)
210 #define DRAWMODE_NOTRANSPARENCY ((sal_uLong)0x80000000)
211
212 // Antialiasing
213 #define ANTIALIASING_DISABLE_TEXT ((sal_uInt16)0x0001)
214 #define ANTIALIASING_ENABLE_B2DDRAW ((sal_uInt16)0x0002)
215 #define ANTIALIASING_PIXELSNAPHAIRLINE ((sal_uInt16)0x0004)
216
217 // AddFontSubstitute
218 #define FONT_SUBSTITUTE_ALWAYS ((sal_uInt16)0x0001)
219 #define FONT_SUBSTITUTE_SCREENONLY ((sal_uInt16)0x0002)
220
221 #define DEFAULTFONT_FLAGS_ONLYONE ((sal_uLong)0x00000001)
222
223 enum OutDevType { OUTDEV_DONTKNOW, OUTDEV_WINDOW, OUTDEV_PRINTER, OUTDEV_VIRDEV };
224
225 enum OutDevViewType { OUTDEV_VIEWTYPE_DONTKNOW, OUTDEV_VIEWTYPE_PRINTPREVIEW, OUTDEV_VIEWTYPE_SLIDESHOW };
226
227 // OutputDevice
228
229 class VirtualDevice;
230 class Printer;
231 class FontSelectPattern;
232 class ImplFontMetricData;
233 class VCLXGraphics;
234
235 typedef ::std::vector< VCLXGraphics* > VCLXGraphicsList_impl;
236
237 sal_uLong AdjustTwoRect( SalTwoRect& rTwoRect, const Size& rSizePix );
238 void AdjustTwoRect( SalTwoRect& rTwoRect, const Rectangle& rValidSrcRect );
239
240 extern const sal_uLong nVCLRLut[ 6 ];
241 extern const sal_uLong nVCLGLut[ 6 ];
242 extern const sal_uLong nVCLBLut[ 6 ];
243 extern const sal_uLong nVCLDitherLut[ 256 ];
244 extern const sal_uLong nVCLLut[ 256 ];
245
246 class VCL_DLLPUBLIC OutputDevice
247 {
248 friend class Application;
249 friend class Bitmap;
250 friend class ImplImageBmp;
251 friend class Printer;
252 friend class System;
253 friend class VirtualDevice;
254 friend class Window;
255 friend class WorkWindow;
256 friend class vcl::PDFWriterImpl;
257 friend void ImplHandleResize( Window* pWindow, long nNewWidth, long nNewHeight );
258
259 private:
260 mutable SalGraphics* mpGraphics; ///< Graphics context to draw on
261 mutable OutputDevice* mpPrevGraphics; ///< Previous output device in list
262 mutable OutputDevice* mpNextGraphics; ///< Next output device in list
263 GDIMetaFile* mpMetaFile;
264 mutable ImplFontEntry* mpFontEntry;
265 mutable ImplFontCache* mpFontCache;
266 mutable PhysicalFontCollection* mpFontCollection;
267 mutable ImplGetDevFontList* mpGetDevFontList;
268 mutable ImplGetDevSizeList* mpGetDevSizeList;
269 boost::ptr_deque<OutDevState>* mpOutDevStateStack;
270 ImplOutDevData* mpOutDevData;
271 VCLXGraphicsList_impl* mpUnoGraphicsList;
272 vcl::PDFWriterImpl* mpPDFWriter;
273 vcl::ExtOutDevData* mpExtOutDevData;
274
275 // TEMP TEMP TEMP
276 VirtualDevice* mpAlphaVDev;
277
278 /// Additional output pixel offset, applied in LogicToPixel (used by SetPixelOffset/GetPixelOffset)
279 long mnOutOffOrigX;
280 /// Additional output offset in _logical_ coordinates, applied in PixelToLogic (used by SetPixelOffset/GetPixelOffset)
281 long mnOutOffLogicX;
282 /// Additional output pixel offset, applied in LogicToPixel (used by SetPixelOffset/GetPixelOffset)
283 long mnOutOffOrigY;
284 /// Additional output offset in _logical_ coordinates, applied in PixelToLogic (used by SetPixelOffset/GetPixelOffset)
285 long mnOutOffLogicY;
286 /// Output offset for device output in pixel (pseudo window offset within window system's frames)
287 long mnOutOffX;
288 /// Output offset for device output in pixel (pseudo window offset within window system's frames)
289 long mnOutOffY;
290 long mnOutWidth;
291 long mnOutHeight;
292 sal_Int32 mnDPIX;
293 sal_Int32 mnDPIY;
294 sal_Int32 mnDPIScaleFactor; ///< For Hi-DPI displays, we want to draw everything mnDPIScaleFactor-times larger
295 /// font specific text alignment offsets in pixel units
296 mutable long mnTextOffX;
297 mutable long mnTextOffY;
298 mutable long mnEmphasisAscent;
299 mutable long mnEmphasisDescent;
300 sal_uLong mnDrawMode;
301 sal_uLong mnTextLayoutMode;
302 ImplMapRes maMapRes;
303 ImplThresholdRes maThresRes;
304 OutDevType meOutDevType;
305 OutDevViewType meOutDevViewType;
306 Region maRegion; // contains the clip region, see SetClipRegion(...)
307 Color maLineColor;
308 Color maFillColor;
309 Font maFont;
310 Color maTextColor;
311 Color maTextLineColor;
312 Color maOverlineColor;
313 TextAlign meTextAlign;
314 RasterOp meRasterOp;
315 Wallpaper maBackground;
316 boost::scoped_ptr<AllSettings> mxSettings;
317 MapMode maMapMode;
318 Point maRefPoint;
319 sal_uInt16 mnAntialiasing;
320 LanguageType meTextLanguage;
321
322 /// bitfield
323 mutable bool mbMap : 1;
324 mutable bool mbMapIsDefault : 1;
325 mutable bool mbClipRegion : 1;
326 mutable bool mbBackground : 1;
327 mutable bool mbOutput : 1;
328 mutable bool mbDevOutput : 1;
329 mutable bool mbOutputClipped : 1;
330 mutable bool mbLineColor : 1;
331 mutable bool mbFillColor : 1;
332 mutable bool mbInitLineColor : 1;
333 mutable bool mbInitFillColor : 1;
334 mutable bool mbInitFont : 1;
335 mutable bool mbInitTextColor : 1;
336 mutable bool mbInitClipRegion : 1;
337 mutable bool mbClipRegionSet : 1;
338 mutable bool mbKerning : 1;
339 mutable bool mbNewFont : 1;
340 mutable bool mbTextLines : 1;
341 mutable bool mbTextSpecial : 1;
342 mutable bool mbRefPoint : 1;
343 mutable bool mbEnableRTL : 1;
344
345 /** @name Initialization and accessor functions
346 */
347 ///@{
348
349 protected:
350 OutputDevice();
351
352 private:
353 SAL_DLLPRIVATE OutputDevice( const OutputDevice& rOutDev );
354
355 public:
356 virtual ~OutputDevice();
357
358 private:
359 SAL_DLLPRIVATE OutputDevice& operator =( const OutputDevice& rOutDev );
360
361 public:
362
363 /** Get the graphic context that the output device uses to draw on.
364
365 If no graphics device exists, then initialize it.
366
367 @returns SalGraphics instance.
368 */
369 SalGraphics const *GetGraphics() const;
370 SalGraphics* GetGraphics();
371
372 void SetConnectMetaFile( GDIMetaFile* pMtf );
373 GDIMetaFile* GetConnectMetaFile() const { return mpMetaFile; }
374
375 virtual void SetSettings( const AllSettings& rSettings );
376 const AllSettings& GetSettings() const { return *mxSettings; }
377
378 SystemGraphicsData GetSystemGfxData() const;
379 css::uno::Any GetSystemGfxDataAny() const;
380
381 void SetRefPoint();
382 void SetRefPoint( const Point& rRefPoint );
383 const Point& GetRefPoint() const { return maRefPoint; }
384 bool IsRefPoint() const { return mbRefPoint; }
385
386 virtual sal_uInt16 GetBitCount() const;
387
388 Size GetOutputSizePixel() const
389 { return Size( mnOutWidth, mnOutHeight ); }
390 long GetOutputWidthPixel() const { return mnOutWidth; }
391 long GetOutputHeightPixel() const { return mnOutHeight; }
392 long GetOutOffXPixel() const { return mnOutOffX; }
393 long GetOutOffYPixel() const { return mnOutOffY; }
394
395 Size GetOutputSize() const
396 { return PixelToLogic( GetOutputSizePixel() ); }
397
398 sal_uLong GetColorCount() const;
399
400
401 /// request XCanvas render interface for this OutputDevice
402 css::uno::Reference< css::rendering::XCanvas >
403 GetCanvas() const;
404
405 css::uno::Reference< css::awt::XGraphics >
406 CreateUnoGraphics();
407 VCLXGraphicsList_impl* GetUnoGraphicsList() const { return mpUnoGraphicsList; }
408 VCLXGraphicsList_impl* CreateUnoGraphicsList();
409
410 protected:
411
412 /** Acquire a graphics device that the output device uses to draw on.
413
414 There is an LRU of OutputDevices that is used to get the graphics. The
415 actual creation of a SalGraphics instance is done via the SalFrame
416 implementation.
417
418 However, the SalFrame instance will only return a valid SalGraphics
419 instance if it is not in use or there wasn't one in the first place. When
420 this happens, AcquireGraphics finds the least recently used OutputDevice
421 in a different frame and "steals" it (releases it then starts using it).
422
423 If there are no frames to steal an OutputDevice's SalGraphics instance from
424 then it blocks until the graphics is released.
425
426 Once it has acquired a graphics instance, then we add the OutputDevice to
427 the LRU.
428
429 @returns true if was able to initialize the graphics device, false otherwise.
430 */
431 virtual bool AcquireGraphics() const = 0;
432
433 /** Release the graphics device, and remove it from the graphics device
434 list.
435
436 @param bRelease Determines whether to release the fonts of the
437 physically released graphics device.
438 */
439 virtual void ReleaseGraphics( bool bRelease = true ) = 0;
440 ///@}
441
442
443 /** @name Helper functions
444 */
445 ///@{
446
447 public:
448
449 /** Get the output device's DPI x-axis value.
450
451 @returns x-axis DPI value
452 */
453 SAL_DLLPRIVATE sal_Int32 GetDPIX() const { return mnDPIX; }
454
455 /** Get the output device's DPI y-axis value.
456
457 @returns y-axis DPI value
458 */
459 SAL_DLLPRIVATE sal_Int32 GetDPIY() const { return mnDPIY; }
460
461 sal_Int32 GetDPIScaleFactor() const { return mnDPIScaleFactor; }
462
463 OutDevType GetOutDevType() const { return meOutDevType; }
464
465 /** Query an OutputDevice to see whether it supports a specific operation
466
467 @returns true if operation supported, else false
468 */
469 bool SupportsOperation( OutDevSupportType ) const;
470
471 vcl::PDFWriterImpl* GetPDFWriter() const { return mpPDFWriter; }
472
473 void SetExtOutDevData( vcl::ExtOutDevData* pExtOutDevData ) { mpExtOutDevData = pExtOutDevData; }
474 vcl::ExtOutDevData* GetExtOutDevData() const { return mpExtOutDevData; }
475
476 private:
477
478 SAL_DLLPRIVATE void ImplRotatePos( long nOriginX, long nOriginY, long& rX, long &rY,
479 short nOrientation ) const;
480 ///@}
481
482
483 /** @name Frame functions
484 */
485 ///@{
486
487 private:
488
489 SAL_DLLPRIVATE void ImplGetFrameDev ( const Point& rPt, const Point& rDevPt, const Size& rDevSize,
490 OutputDevice& rOutDev );
491 SAL_DLLPRIVATE void ImplDrawFrameDev ( const Point& rPt, const Point& rDevPt, const Size& rDevSize,
492 const OutputDevice& rOutDev, const Region& rRegion );
493 ///@}
494
495
496 /** @Name Direct OutputDevice drawing functions
497 */
498 ///@{
499
500 public:
501
502 virtual void DrawOutDev(
503 const Point& rDestPt, const Size& rDestSize,
504 const Point& rSrcPt, const Size& rSrcSize );
505
506 virtual void DrawOutDev(
507 const Point& rDestPt, const Size& rDestSize,
508 const Point& rSrcPt, const Size& rSrcSize,
509 const OutputDevice& rOutDev );
510
511 virtual void CopyArea(
512 const Point& rDestPt,
513 const Point& rSrcPt, const Size& rSrcSize,
514 sal_uInt16 nFlags = 0 );
515
516 protected:
517
518 virtual void CopyDeviceArea( SalTwoRect& aPosAry, sal_uInt32 nFlags);
519
520 private:
521
522 SAL_DLLPRIVATE void ImplDrawOutDevDirect ( const OutputDevice* pSrcDev, SalTwoRect& rPosAry );
523
524 // not implemented; to detect misuses of DrawOutDev(...OutputDevice&);
525 SAL_DLLPRIVATE void DrawOutDev( const Point&, const Size&, const Point&, const Size&, const Printer&) SAL_DELETED_FUNCTION;
526 ///@}
527
528
529 /** @name OutputDevice state functions
530 */
531 ///@{
532
533 public:
534
535 void Push( sal_uInt16 nFlags = PUSH_ALL );
536 void Pop();
537
538 // returns the current stack depth; that is the number of Push() calls minus the number of Pop() calls
539 // this should not normally be used since Push and Pop must always be used symmetrically
540 // however this may be e.g. a help when debugging code in which this somehow is not the case
541 sal_uInt32 GetGCStackDepth() const;
542
543 void EnableOutput( bool bEnable = true );
544 bool IsOutputEnabled() const { return mbOutput; }
545 bool IsDeviceOutput() const { return mbDevOutput; }
546 bool IsDeviceOutputNecessary() const { return (mbOutput && mbDevOutput); }
547 bool IsOutputNecessary() const { return ((mbOutput && mbDevOutput) || (mpMetaFile != NULL)); }
548
549 void SetAntialiasing( sal_uInt16 nMode = 0 );
550 sal_uInt16 GetAntialiasing() const { return mnAntialiasing; }
551
552 void SetDrawMode( sal_uLong nDrawMode );
553 sal_uLong GetDrawMode() const { return mnDrawMode; }
554
555 void SetLayoutMode( sal_uLong nTextLayoutMode );
556 sal_uLong GetLayoutMode() const { return mnTextLayoutMode; }
557
558 void SetDigitLanguage( LanguageType );
559 LanguageType GetDigitLanguage() const { return meTextLanguage; }
560
561 void SetRasterOp( RasterOp eRasterOp );
562 RasterOp GetRasterOp() const { return meRasterOp; }
563
564 /**
565 If this OutputDevice is used for displaying a Print Preview
566 the OutDevViewType should be set to 'OUTDEV_VIEWTYPE_PRINTPREVIEW'.
567
568 A View can then make painting decisions dependent on this OutDevViewType.
569 E.g. text colors need to be handled differently, dependent on whether it's a PrintPreview or not. (see #106611# for more)
570 */
571 void SetOutDevViewType( OutDevViewType eOutDevViewType ) { meOutDevViewType=eOutDevViewType; }
572 OutDevViewType GetOutDevViewType() const { return meOutDevViewType; }
573
574 void SetLineColor();
575 void SetLineColor( const Color& rColor );
576 const Color& GetLineColor() const { return maLineColor; }
577 bool IsLineColor() const { return mbLineColor; }
578
579 void SetFillColor();
580 void SetFillColor( const Color& rColor );
581 const Color& GetFillColor() const { return maFillColor; }
582 bool IsFillColor() const { return mbFillColor; }
583
584 void SetBackground();
585 void SetBackground( const Wallpaper& rBackground );
586
587 const Wallpaper& GetBackground() const { return maBackground; }
588 bool IsBackground() const { return mbBackground; }
589
590 void SetFont( const Font& rNewFont );
591 const Font& GetFont() const { return maFont; }
592
593 protected:
594
595 virtual void ImplReleaseFonts();
596
597 private:
598
599 SAL_DLLPRIVATE void InitLineColor();
600
601 SAL_DLLPRIVATE void InitFillColor();
602
603 ///@}
604
605
606 /** @name Clipping functions
607 */
608 ///@{
609
610 public:
611
612 Region GetClipRegion() const;
613 void SetClipRegion();
614 void SetClipRegion( const Region& rRegion );
615 bool SelectClipRegion( const Region&, SalGraphics* pGraphics = NULL );
616
617 bool IsClipRegion() const { return mbClipRegion; }
618
619 void MoveClipRegion( long nHorzMove, long nVertMove );
620 void IntersectClipRegion( const Rectangle& rRect );
621 void IntersectClipRegion( const Region& rRegion );
622
623 virtual Region GetActiveClipRegion() const;
624
625 protected:
626
627 virtual void InitClipRegion();
628 virtual void ClipToPaintRegion ( Rectangle& rDstRect );
629
630 private:
631
632 SAL_DLLPRIVATE void SetDeviceClipRegion( const Region* pRegion );
633 ///@}
634
635
636 /** @name Pixel functions
637 */
638 ///@{
639
640 public:
641
642 void DrawPixel( const Point& rPt );
643 void DrawPixel( const Point& rPt, const Color& rColor );
644 void DrawPixel( const Polygon& rPts, const Color* pColors = NULL );
645 void DrawPixel( const Polygon& rPts, const Color& rColor );
646
647 Color GetPixel( const Point& rPt ) const;
648 ///@}
649
650
651 /** @name Rectangle functions
652 */
653 ///@{
654
655 public:
656
657 void DrawRect( const Rectangle& rRect );
658 void DrawRect( const Rectangle& rRect,
659 sal_uLong nHorzRount, sal_uLong nVertRound );
660
661 /// Fill the given rectangle with checkered rectangles of size nLen x nLen using the colors aStart and aEnd
662 void DrawCheckered(
663 const Point& rPos,
664 const Size& rSize,
665 sal_uInt32 nLen = 8,
666 Color aStart = Color(COL_WHITE),
667 Color aEnd = Color(COL_BLACK));
668
669 void DrawGrid( const Rectangle& rRect, const Size& rDist, sal_uLong nFlags );
670
671 ///@}
672
673
674 /** @name Line functions
675 */
676 ///@{
677
678 public:
679
680 void DrawLine( const Point& rStartPt, const Point& rEndPt );
681
682 void DrawLine( const Point& rStartPt, const Point& rEndPt,
683 const LineInfo& rLineInfo );
684
685 private:
686
687 /** Helper for line geometry paint with support for graphic expansion (pattern and fat_to_area)
688 */
689 SAL_DLLPRIVATE void PaintLineGeometryWithEvtlExpand( const LineInfo& rInfo, basegfx::B2DPolyPolygon aLinePolyPolygon );
690 ///@}
691
692
693 /** @name Polyline functions
694 */
695 ///@{
696
697 public:
698
699 /** Render the given polygon as a line stroke
700
701 The given polygon is stroked with the current LineColor, start
702 and end point are not automatically connected
703
704 @see DrawPolygon
705 @see DrawPolyPolygon
706 */
707 void DrawPolyLine( const Polygon& rPoly );
708
709 void DrawPolyLine(
710 const basegfx::B2DPolygon&,
711 double fLineWidth = 0.0,
712 basegfx::B2DLineJoin = basegfx::B2DLINEJOIN_ROUND,
713 css::drawing::LineCap = css::drawing::LineCap_BUTT);
714
715 /** Render the given polygon as a line stroke
716
717 The given polygon is stroked with the current LineColor, start
718 and end point are not automatically connected. The line is
719 rendered according to the specified LineInfo, e.g. supplying a
720 dash pattern, or a line thickness.
721
722 @see DrawPolygon
723 @see DrawPolyPolygon
724 */
725 void DrawPolyLine( const Polygon& rPoly,
726 const LineInfo& rLineInfo );
727
728 bool TryDrawPolyLineDirect(
729 const basegfx::B2DPolygon& rB2DPolygon,
730 double fLineWidth = 0.0,
731 double fTransparency = 0.0,
732 basegfx::B2DLineJoin eLineJoin = basegfx::B2DLINEJOIN_NONE,
733 css::drawing::LineCap eLineCap = css::drawing::LineCap_BUTT);
734 private:
735
736 // #i101491#
737 // Helper which holds the old line geometry creation and is extended to use AA when
738 // switched on. Advantage is that line geometry is only temporarily used for paint
739 SAL_DLLPRIVATE void DrawPolyLineWithLineInfo(const Polygon& rPoly, const LineInfo& rLineInfo);
740
741
742 // #i101491#
743 // Helper who tries to use SalGDI's DrawPolyLine direct and returns it's bool. Contains no AA check.
744 SAL_DLLPRIVATE bool TryDrawPolyLineDirectNoAACheck(
745 const basegfx::B2DPolygon& rB2DPolygon,
746 double fLineWidth = 0.0,
747 double fTransparency = 0.0,
748 basegfx::B2DLineJoin eLineJoin = basegfx::B2DLINEJOIN_NONE,
749 css::drawing::LineCap eLineCap = css::drawing::LineCap_BUTT);
750 ///@}
751
752
753 /** @name Polygon functions
754 */
755 ///@{
756
757 public:
758
759 /** Render the given polygon
760
761 The given polygon is stroked with the current LineColor, and
762 filled with the current FillColor. If one of these colors are
763 transparent, the corresponding stroke or fill stays
764 invisible. Start and end point of the polygon are
765 automatically connected.
766
767 @see DrawPolyLine
768 */
769 void DrawPolygon( const Polygon& rPoly );
770 void DrawPolygon( const basegfx::B2DPolygon& );
771
772 /** Render the given poly-polygon
773
774 The given poly-polygon is stroked with the current LineColor,
775 and filled with the current FillColor. If one of these colors
776 are transparent, the corresponding stroke or fill stays
777 invisible. Start and end points of the contained polygons are
778 automatically connected.
779
780 @see DrawPolyLine
781 */
782 void DrawPolyPolygon( const PolyPolygon& rPolyPoly );
783 void DrawPolyPolygon( const basegfx::B2DPolyPolygon& );
784
785 private:
786
787 SAL_DLLPRIVATE void ImplDrawPolygon( const Polygon& rPoly, const PolyPolygon* pClipPolyPoly = NULL );
788 SAL_DLLPRIVATE void ImplDrawPolyPolygon( const PolyPolygon& rPolyPoly, const PolyPolygon* pClipPolyPoly = NULL );
789 SAL_DLLPRIVATE void ImplDrawPolyPolygon( sal_uInt16 nPoly, const PolyPolygon& rPolyPoly );
790 // #i101491#
791 // Helper who implements the DrawPolyPolygon functionality for basegfx::B2DPolyPolygon
792 // without MetaFile processing
793 SAL_DLLPRIVATE void ImplDrawPolyPolygonWithB2DPolyPolygon(const basegfx::B2DPolyPolygon& rB2DPolyPoly);
794 ///@}
795
796
797 /** @name Curved shape functions
798 */
799 ///@{
800
801 public:
802
803 void DrawEllipse( const Rectangle& rRect );
804
805 void DrawArc(
806 const Rectangle& rRect,
807 const Point& rStartPt, const Point& rEndPt );
808
809 void DrawPie(
810 const Rectangle& rRect,
811 const Point& rStartPt, const Point& rEndPt );
812
813 void DrawChord(
814 const Rectangle& rRect,
815 const Point& rStartPt, const Point& rEndPt );
816
817 ///@}
818
819
820 /** @name Gradient functions
821 */
822 ///@{
823
824 public:
825 void DrawGradient( const Rectangle& rRect, const Gradient& rGradient );
826 void DrawGradient( const PolyPolygon& rPolyPoly, const Gradient& rGradient );
827
828 void AddGradientActions(
829 const Rectangle& rRect,
830 const Gradient& rGradient,
831 GDIMetaFile& rMtf );
832
833 protected:
834
835 virtual bool UsePolyPolygonForComplexGradient() = 0;
836
837 virtual long GetGradientStepCount( long nMinRect );
838
839 private:
840
841 SAL_DLLPRIVATE void DrawLinearGradient( const Rectangle& rRect, const Gradient& rGradient, bool bMtf, const PolyPolygon* pClipPolyPoly );
842 SAL_DLLPRIVATE void DrawComplexGradient( const Rectangle& rRect, const Gradient& rGradient, bool bMtf, const PolyPolygon* pClipPolyPoly );
843
844 SAL_DLLPRIVATE long GetGradientSteps( const Gradient& rGradient, const Rectangle& rRect, bool bMtf, bool bComplex=false );
845
846 SAL_DLLPRIVATE Color GetSingleColorGradientFill();
847 SAL_DLLPRIVATE void SetGrayscaleColors( Gradient &rGradient );
848 ///@}
849
850
851 /** @name Hatch functions
852 */
853 ///@{
854
855 public:
856
857 #ifdef _MSC_VER
858 void DrawHatch( const PolyPolygon& rPolyPoly, const ::Hatch& rHatch );
859 void AddHatchActions( const PolyPolygon& rPolyPoly,
860 const ::Hatch& rHatch,
861 GDIMetaFile& rMtf );
862 #else
863 void DrawHatch( const PolyPolygon& rPolyPoly, const Hatch& rHatch );
864 void AddHatchActions( const PolyPolygon& rPolyPoly,
865 const Hatch& rHatch,
866 GDIMetaFile& rMtf );
867 #endif
868
869 void DrawHatch( const PolyPolygon& rPolyPoly, const Hatch& rHatch, bool bMtf );
870
871 private:
872
873 SAL_DLLPRIVATE void CalcHatchValues( const Rectangle& rRect, long nDist, sal_uInt16 nAngle10, Point& rPt1, Point& rPt2, Size& rInc, Point& rEndPt1 );
874 SAL_DLLPRIVATE void DrawHatchLine( const Line& rLine, const PolyPolygon& rPolyPoly, Point* pPtBuffer, bool bMtf );
875 ///@}
876
877
878 /** @name Wallpaper functions
879 */
880 ///@{
881
882 public:
883 void DrawWallpaper( const Rectangle& rRect, const Wallpaper& rWallpaper );
884
885 virtual void Erase();
886 virtual void Erase( const Rectangle& rRect ) { DrawWallpaper( rRect, GetBackground() ); }
887
888 protected:
889 virtual void DrawGradientWallpaper( long nX, long nY, long nWidth, long nHeight, const Wallpaper& rWallpaper );
890
891 private:
892 SAL_DLLPRIVATE void DrawWallpaper( long nX, long nY, long nWidth, long nHeight, const Wallpaper& rWallpaper );
893 SAL_DLLPRIVATE void DrawColorWallpaper( long nX, long nY, long nWidth, long nHeight, const Wallpaper& rWallpaper );
894 SAL_DLLPRIVATE void DrawBitmapWallpaper( long nX, long nY, long nWidth, long nHeight, const Wallpaper& rWallpaper );
895 ///@}
896
897
898 /** @name Text functions
899 */
900 ///@{
901
902 public:
903
904 void DrawText( const Point& rStartPt, const OUString& rStr,
905 sal_Int32 nIndex = 0, sal_Int32 nLen = -1,
906 MetricVector* pVector = NULL, OUString* pDisplayText = NULL );
907
908 void DrawText( const Rectangle& rRect,
909 const OUString& rStr, sal_uInt16 nStyle = 0,
910 MetricVector* pVector = NULL, OUString* pDisplayText = NULL,
911 ::vcl::ITextLayout* _pTextLayout = NULL );
912
913 void ImplDrawText( OutputDevice& rTargetDevice, const Rectangle& rRect,
914 const OUString& rOrigStr, sal_uInt16 nStyle,
915 MetricVector* pVector, OUString* pDisplayText, ::vcl::ITextLayout& _rLayout );
916
917 void ImplDrawText( SalLayout& );
918
919 void ImplDrawTextBackground( const SalLayout& );
920
921 void DrawCtrlText( const Point& rPos, const OUString& rStr,
922 sal_Int32 nIndex = 0, sal_Int32 nLen = -1,
923 sal_uInt16 nStyle = TEXT_DRAW_MNEMONIC, MetricVector* pVector = NULL, OUString* pDisplayText = NULL );
924
925 void DrawTextLine( const Point& rPos, long nWidth,
926 FontStrikeout eStrikeout,
927 FontUnderline eUnderline,
928 FontUnderline eOverline,
929 bool bUnderlineAbove = false );
930
931 void ImplDrawTextLine( long nBaseX, long nX, long nY, long nWidth, FontStrikeout eStrikeout, FontUnderline eUnderline, FontUnderline eOverline, bool bUnderlineAbove );
932
933 void ImplDrawTextLines( SalLayout&, FontStrikeout eStrikeout, FontUnderline eUnderline, FontUnderline eOverline, bool bWordLine, bool bUnderlineAbove );
934
935 void DrawWaveLine( const Point& rStartPos, const Point& rEndPos );
936
937 bool ImplDrawRotateText( SalLayout& );
938
939 Rectangle GetTextRect( const Rectangle& rRect,
940 const OUString& rStr, sal_uInt16 nStyle = TEXT_DRAW_WORDBREAK,
941 TextRectInfo* pInfo = NULL,
942 const ::vcl::ITextLayout* _pTextLayout = NULL ) const;
943
944 bool GetTextBoundRect( Rectangle& rRect,
945 const OUString& rStr, sal_Int32 nBase = 0, sal_Int32 nIndex = 0, sal_Int32 nLen = -1,
946 sal_uLong nLayoutWidth = 0, const sal_Int32* pDXArray = NULL ) const;
947
948 Rectangle ImplGetTextBoundRect( const SalLayout& );
949
950 bool GetTextOutline( PolyPolygon&,
951 const OUString& rStr, sal_Int32 nBase = 0, sal_Int32 nIndex = 0,
952 sal_Int32 nLen = -1, bool bOptimize = true,
953 sal_uLong nLayoutWidth = 0, const sal_Int32* pDXArray = NULL ) const;
954
955 bool GetTextOutlines( PolyPolyVector&,
956 const OUString& rStr, sal_Int32 nBase = 0, sal_Int32 nIndex = 0,
957 sal_Int32 nLen = -1, bool bOptimize = true,
958 sal_uLong nLayoutWidth = 0, const sal_Int32* pDXArray = NULL ) const;
959
960 bool GetTextOutlines( ::basegfx::B2DPolyPolygonVector &rVector,
961 const OUString& rStr, sal_Int32 nBase = 0, sal_Int32 nIndex = 0,
962 sal_Int32 nLen = -1, bool bOptimize = true,
963 sal_uLong nLayoutWidth = 0, const sal_Int32* pDXArray = NULL ) const;
964
965
966 OUString GetEllipsisString( const OUString& rStr, long nMaxWidth,
967 sal_uInt16 nStyle = TEXT_DRAW_ENDELLIPSIS ) const;
968
969 long GetCtrlTextWidth( const OUString& rStr, sal_Int32 nIndex = 0,
970 sal_Int32 nLen = -1,
971 sal_uInt16 nStyle = TEXT_DRAW_MNEMONIC ) const;
972
973 static OUString GetNonMnemonicString( const OUString& rStr, sal_Int32& rMnemonicPos );
974
975 static OUString GetNonMnemonicString( const OUString& rStr )
976 { sal_Int32 nDummy; return GetNonMnemonicString( rStr, nDummy ); }
977
978 /** Generate MetaTextActions for the text rect
979
980 This method splits up the text rect into multiple
981 MetaTextActions, one for each line of text. This is comparable
982 to AddGradientActions(), which splits up a gradient into its
983 constituent polygons. Parameter semantics fully compatible to
984 DrawText().
985 */
986 void AddTextRectActions( const Rectangle& rRect,
987 const OUString& rOrigStr,
988 sal_uInt16 nStyle,
989 GDIMetaFile& rMtf );
990
991 void SetTextColor( const Color& rColor );
992 const Color& GetTextColor() const { return maTextColor; }
993
994 void SetTextFillColor();
995 void SetTextFillColor( const Color& rColor );
996 Color GetTextFillColor() const;
997 bool IsTextFillColor() const { return !maFont.IsTransparent(); }
998
999 void SetTextLineColor();
1000 void SetTextLineColor( const Color& rColor );
1001 const Color& GetTextLineColor() const { return maTextLineColor; }
1002 bool IsTextLineColor() const { return (maTextLineColor.GetTransparency() == 0); }
1003
1004 void SetOverlineColor();
1005 void SetOverlineColor( const Color& rColor );
1006 const Color& GetOverlineColor() const { return maOverlineColor; }
1007 bool IsOverlineColor() const { return (maOverlineColor.GetTransparency() == 0); }
1008
1009 void SetTextAlign( TextAlign eAlign );
1010 TextAlign GetTextAlign() const { return maFont.GetAlign(); }
1011
1012 long GetTextWidth( const OUString& rStr, sal_Int32 nIndex = 0, sal_Int32 nLen = -1 ) const;
1013 /// Height where any character of the current font fits; in logic coordinates.
1014 long GetTextHeight() const;
1015 float approximate_char_width() const;
1016
1017 void DrawTextArray( const Point& rStartPt, const OUString& rStr,
1018 const sal_Int32* pDXAry = NULL,
1019 sal_Int32 nIndex = 0,
1020 sal_Int32 nLen = -1 );
1021 long GetTextArray( const OUString& rStr, sal_Int32* pDXAry = NULL,
1022 sal_Int32 nIndex = 0, sal_Int32 nLen = -1 ) const;
1023
1024 bool GetCaretPositions( const OUString&, sal_Int32* pCaretXArray,
1025 sal_Int32 nIndex, sal_Int32 nLen,
1026 sal_Int32* pDXAry = NULL, long nWidth = 0,
1027 bool bCellBreaking = true ) const;
1028 void DrawStretchText( const Point& rStartPt, sal_uLong nWidth,
1029 const OUString& rStr,
1030 sal_Int32 nIndex = 0, sal_Int32 nLen = -1 );
1031 sal_Int32 GetTextBreak( const OUString& rStr, long nTextWidth,
1032 sal_Int32 nIndex = 0, sal_Int32 nLen = -1,
1033 long nCharExtra = 0 ) const;
1034 sal_Int32 GetTextBreak( const OUString& rStr, long nTextWidth,
1035 sal_Unicode nExtraChar, sal_Int32& rExtraCharPos,
1036 sal_Int32 nIndex, sal_Int32 nLen,
1037 long nCharExtra = 0 ) const;
1038
1039 private:
1040 SAL_DLLPRIVATE void ImplInitTextColor();
1041
1042 SAL_DLLPRIVATE void ImplInitTextLineSize();
1043 SAL_DLLPRIVATE void ImplInitAboveTextLineSize();
1044
1045
1046 SAL_DLLPRIVATE bool ImplDrawTextDirect( SalLayout&, bool bTextLines, sal_uInt32 flags = 0 );
1047 SAL_DLLPRIVATE void ImplDrawSpecialText( SalLayout& );
1048 SAL_DLLPRIVATE void ImplDrawTextRect( long nBaseX, long nBaseY, long nX, long nY, long nWidth, long nHeight );
1049
1050 SAL_DLLPRIVATE void ImplDrawWavePixel( long nOriginX, long nOriginY, long nCurX, long nCurY, short nOrientation, SalGraphics* pGraphics, OutputDevice* pOutDev,
1051 bool bDrawPixAsRect, long nPixWidth, long nPixHeight );
1052 SAL_DLLPRIVATE void ImplDrawWaveLine( long nBaseX, long nBaseY, long nStartX, long nStartY, long nWidth, long nHeight, long nLineWidth, short nOrientation, const Color& rColor );
1053 SAL_DLLPRIVATE void ImplDrawWaveTextLine( long nBaseX, long nBaseY, long nX, long nY, long nWidth, FontUnderline eTextLine, Color aColor, bool bIsAbove );
1054 SAL_DLLPRIVATE void ImplDrawStraightTextLine( long nBaseX, long nBaseY, long nX, long nY, long nWidth, FontUnderline eTextLine, Color aColor, bool bIsAbove );
1055 SAL_DLLPRIVATE void ImplDrawStrikeoutLine( long nBaseX, long nBaseY, long nX, long nY, long nWidth, FontStrikeout eStrikeout, Color aColor );
1056 SAL_DLLPRIVATE void ImplDrawStrikeoutChar( long nBaseX, long nBaseY, long nX, long nY, long nWidth, FontStrikeout eStrikeout, Color aColor );
1057 SAL_DLLPRIVATE void ImplDrawMnemonicLine( long nX, long nY, long nWidth );
1058
1059 SAL_DLLPRIVATE static bool ImplIsUnderlineAbove( const Font& );
1060
1061 static
1062 SAL_DLLPRIVATE long ImplGetTextLines( ImplMultiTextLineInfo& rLineInfo, long nWidth, const OUString& rStr, sal_uInt16 nStyle, const ::vcl::ITextLayout& _rLayout );
1063 ///@}
1064
1065
1066 /** @name Font functions
1067 */
1068 ///@{
1069
1070 public:
1071
1072 FontInfo GetDevFont( int nDevFontIndex ) const;
1073 int GetDevFontCount() const;
1074
1075 bool IsFontAvailable( const OUString& rFontName ) const;
1076
1077 Size GetDevFontSize( const Font& rFont, int nSizeIndex ) const;
1078 int GetDevFontSizeCount( const Font& ) const;
1079
1080 bool AddTempDevFont( const OUString& rFileURL, const OUString& rFontName );
1081
1082 FontMetric GetFontMetric() const;
1083 FontMetric GetFontMetric( const Font& rFont ) const;
1084
1085 bool GetFontCharMap( FontCharMap& rFontCharMap ) const;
1086 bool GetFontCapabilities( vcl::FontCapabilities& rFontCapabilities ) const;
1087
1088 /** Retrieve detailed font information in platform independent structure
1089
1090 @param nFallbacklevel Fallback font level (0 = best matching font)
1091
1092 @return SystemFontData
1093 */
1094 SystemFontData GetSysFontData( int nFallbacklevel ) const;
1095
1096 SAL_DLLPRIVATE void ImplGetEmphasisMark( PolyPolygon& rPolyPoly, bool& rPolyLine, Rectangle& rRect1, Rectangle& rRect2,
1097 long& rYOff, long& rWidth, FontEmphasisMark eEmphasis, long nHeight, short nOrient );
1098 SAL_DLLPRIVATE static FontEmphasisMark
1099 ImplGetEmphasisMarkStyle( const Font& rFont );
1100
1101 bool GetGlyphBoundRects( const Point& rOrigin, const OUString& rStr, int nIndex,
1102 int nLen, int nBase, MetricVector& rVector );
1103
1104 sal_Int32 HasGlyphs( const Font& rFont, const OUString& rStr,
1105 sal_Int32 nIndex = 0, sal_Int32 nLen = -1 ) const;
1106
1107 long GetMinKashida() const;
1108
1109 // i60594
1110 // validate kashida positions against the current font
1111 // returns count of invalid kashida positions
1112 sal_Int32 ValidateKashidas( const OUString& rTxt, sal_Int32 nIdx, sal_Int32 nLen,
1113 sal_Int32 nKashCount, // number of suggested kashida positions (in)
1114 const sal_Int32* pKashidaPos, // suggested kashida positions (in)
1115 sal_Int32* pKashidaPosDropped // invalid kashida positions (out)
1116 ) const;
1117
1118 static void BeginFontSubstitution();
1119 static void EndFontSubstitution();
1120 static void AddFontSubstitute( const OUString& rFontName,
1121 const OUString& rReplaceFontName,
1122 sal_uInt16 nFlags = 0 );
1123 static void RemoveFontSubstitute( sal_uInt16 n );
1124 static sal_uInt16 GetFontSubstituteCount();
1125
1126 static Font GetDefaultFont( sal_uInt16 nType,
1127 LanguageType eLang,
1128 sal_uLong nFlags,
1129 const OutputDevice* pOutDev = NULL );
1130
1131 SAL_DLLPRIVATE void ImplInitFontList() const;
1132 SAL_DLLPRIVATE void ImplUpdateFontData( bool bNewFontLists );
1133 SAL_DLLPRIVATE static void ImplUpdateAllFontData( bool bNewFontLists );
1134
1135 protected:
1136
1137 virtual void InitFont() const;
1138 virtual void SetFontOrientation( ImplFontEntry* const pFontEntry ) const;
1139 virtual long GetFontExtLeading() const;
1140
1141
1142 private:
1143
1144 typedef void ( OutputDevice::* FontUpdateHandler_t )( bool );
1145
1146 SAL_DLLPRIVATE bool ImplNewFont() const;
1147
1148 SAL_DLLPRIVATE void ImplClearFontData( bool bNewFontLists );
1149 SAL_DLLPRIVATE void ImplRefreshFontData( bool bNewFontLists );
1150 SAL_DLLPRIVATE static void ImplUpdateFontDataForAllFrames( FontUpdateHandler_t pHdl, bool bNewFontLists );
1151
1152 static
1153 SAL_DLLPRIVATE OUString ImplGetEllipsisString( const OutputDevice& rTargetDevice, const OUString& rStr,
1154 long nMaxWidth, sal_uInt16 nStyle, const ::vcl::ITextLayout& _rLayout );
1155
1156 SAL_DLLPRIVATE void ImplDrawEmphasisMark( long nBaseX, long nX, long nY, const PolyPolygon& rPolyPoly, bool bPolyLine, const Rectangle& rRect1, const Rectangle& rRect2 );
1157 SAL_DLLPRIVATE void ImplDrawEmphasisMarks( SalLayout& );
1158 ///@}
1159
1160
1161 /** @name Layout functions
1162 */
1163 ///@{
1164
1165 public:
1166
1167 SystemTextLayoutData GetSysTextLayoutData( const Point& rStartPt, const OUString& rStr,
1168 sal_Int32 nIndex = 0, sal_Int32 nLen = -1,
1169 const sal_Int32* pDXAry = NULL ) const;
1170
1171 SAL_DLLPRIVATE bool ImplIsAntiparallel() const ;
1172 SAL_DLLPRIVATE void ReMirror( Point &rPoint ) const;
1173 SAL_DLLPRIVATE void ReMirror( Rectangle &rRect ) const;
1174 SAL_DLLPRIVATE void ReMirror( Region &rRegion ) const;
1175 SAL_DLLPRIVATE bool ImplIsRecordLayout() const;
1176 virtual bool HasMirroredGraphics() const;
1177 SAL_DLLPRIVATE SalLayout* ImplLayout( const OUString&, sal_Int32 nIndex, sal_Int32 nLen,
1178 const Point& rLogicPos = Point(0,0), long nLogicWidth=0,
1179 const sal_Int32* pLogicDXArray=NULL ) const;
1180 SAL_DLLPRIVATE ImplLayoutArgs ImplPrepareLayoutArgs( OUString&, const sal_Int32 nIndex, const sal_Int32 nLen,
1181 long nPixelWidth, const sal_Int32* pPixelDXArray ) const;
1182 SAL_DLLPRIVATE SalLayout* ImplGlyphFallbackLayout( SalLayout*, ImplLayoutArgs& ) const;
1183 // tells whether this output device is RTL in an LTR UI or LTR in a RTL UI
1184 SAL_DLLPRIVATE SalLayout* getFallbackFont(ImplFontEntry &rFallbackFont,
1185 FontSelectPattern &rFontSelData, int nFallbackLevel,
1186 ImplLayoutArgs& rLayoutArgs) const;
1187
1188
1189 // Enabling/disabling RTL only makes sense for OutputDevices that use a mirroring SalGraphisLayout
1190 virtual void EnableRTL( bool bEnable = true);
1191 bool IsRTLEnabled() const { return mbEnableRTL; }
1192
1193 bool GetTextIsRTL( const OUString&, sal_Int32 nIndex, sal_Int32 nLen ) const;
1194
1195 ///@}
1196
1197
1198 /** @name Bitmap functions
1199 */
1200 ///@{
1201
1202 public:
1203
1204 /** @overload
1205 void DrawBitmap(
1206 const Point& rDestPt,
1207 const Size& rDestSize,
1208 const Point& rSrcPtPixel,
1209 const Size& rSecSizePixel,
1210 const Bitmap& rBitmap,
1211 sal_uLong nAction = META_BMPSCALEPART_ACTION)
1212 */
1213 void DrawBitmap(
1214 const Point& rDestPt,
1215 const Bitmap& rBitmap );
1216
1217 /** @overload
1218 void DrawBitmap(
1219 const Point& rDestPt,
1220 const Size& rDestSize,
1221 const Point& rSrcPtPixel,
1222 const Size& rSecSizePixel,
1223 const Bitmap& rBitmap,
1224 sal_uLong nAction = META_BMPSCALEPART_ACTION)
1225 */
1226 void DrawBitmap(
1227 const Point& rDestPt,
1228 const Size& rDestSize,
1229 const Bitmap& rBitmap );
1230
1231 void DrawBitmap(
1232 const Point& rDestPt,
1233 const Size& rDestSize,
1234 const Point& rSrcPtPixel,
1235 const Size& rSrcSizePixel,
1236 const Bitmap& rBitmap,
1237 sal_uLong nAction = META_BMPSCALEPART_ACTION );
1238
1239 /** @overload
1240 void DrawBitmapEx(
1241 const Point& rDestPt,
1242 const Size& rDestSize,
1243 const Point& rSrcPtPixel,
1244 const Size& rSecSizePixel,
1245 const BitmapEx& rBitmapEx,
1246 sal_uLong nAction = META_BMPEXSCALEPART_ACTION)
1247 */
1248 void DrawBitmapEx(
1249 const Point& rDestPt,
1250 const BitmapEx& rBitmapEx );
1251
1252
1253 /** @overload
1254 void DrawBitmapEx(
1255 const Point& rDestPt,
1256 const Size& rDestSize,
1257 const Point& rSrcPtPixel,
1258 const Size& rSecSizePixel,
1259 const BitmapEx& rBitmapEx,
1260 sal_uLong nAction = META_BMPEXSCALEPART_ACTION)
1261 */
1262 void DrawBitmapEx(
1263 const Point& rDestPt,
1264 const Size& rDestSize,
1265 const BitmapEx& rBitmapEx );
1266
1267 void DrawBitmapEx(
1268 const Point& rDestPt,
1269 const Size& rDestSize,
1270 const Point& rSrcPtPixel,
1271 const Size& rSrcSizePixel,
1272 const BitmapEx& rBitmapEx,
1273 sal_uLong nAction = META_BMPEXSCALEPART_ACTION );
1274
1275 /** @overload
1276 virtual void DrawImage(
1277 const Point& rPos,
1278 const Size& rSize,
1279 const Image& rImage,
1280 sal_uInt16 nStyle = 0)
1281 */
1282 virtual void DrawImage(
1283 const Point& rPos,
1284 const Image& rImage,
1285 sal_uInt16 nStyle = 0 );
1286
1287 virtual void DrawImage(
1288 const Point& rPos,
1289 const Size& rSize,
1290 const Image& rImage,
1291 sal_uInt16 nStyle = 0 );
1292
1293
1294 virtual Bitmap GetBitmap( const Point& rSrcPt, const Size& rSize ) const;
1295
1296 /** Query extended bitmap (with alpha channel, if available).
1297 */
1298 BitmapEx GetBitmapEx( const Point& rSrcPt, const Size& rSize ) const;
1299
1300
1301 /** Draw BitmapEx transformed
1302
1303 @param rTransformation
1304 The transformation describing the target positioning of the given bitmap. Transforming
1305 the unit object coordinates (0, 0, 1, 1) with this matrix is the transformation to
1306 discrete coordinates
1307
1308 @param rBitmapEx
1309 The BitmapEx to be painted
1310 */
1311 void DrawTransformedBitmapEx(
1312 const basegfx::B2DHomMatrix& rTransformation,
1313 const BitmapEx& rBitmapEx);
1314
1315
1316 protected:
1317
1318 virtual void DrawDeviceBitmap(
1319 const Point& rDestPt, const Size& rDestSize,
1320 const Point& rSrcPtPixel, const Size& rSrcSizePixel,
1321 BitmapEx& rBitmapEx );
1322
1323 virtual void ScaleBitmap ( Bitmap &rBmp, SalTwoRect &rPosAry );
1324
1325 /** Transform and draw a bitmap directly
1326
1327 @param aFullTransform The B2DHomMatrix used for the transformation
1328 @param rBitmapEx Reference to the bitmap to be transformed and drawn
1329
1330 @return true if it was able to draw the bitmap, false if not
1331 */
1332 virtual bool DrawTransformBitmapExDirect(
1333 const basegfx::B2DHomMatrix& aFullTransform,
1334 const BitmapEx& rBitmapEx);
1335
1336 /** Transform and reduce the area that needs to be drawn of the bitmap and return the new
1337 visible range and the maximum area.
1338
1339
1340 @param aFullTransform B2DHomMatrix used for transformation
1341 @param aVisibleRange The new visible area of the bitmap
1342 @param fMaximumArea The maximum area of the bitmap
1343
1344 @returns true if there is an area to be drawn, otherwise nothing is left to be drawn
1345 so return false
1346 */
1347 virtual bool TransformAndReduceBitmapExToTargetRange(
1348 const basegfx::B2DHomMatrix& aFullTransform,
1349 basegfx::B2DRange &aVisibleRange,
1350 double &fMaximumArea);
1351
1352 private:
1353
1354 SAL_DLLPRIVATE void DrawDeviceAlphaBitmap(
1355 const Bitmap& rBmp,
1356 const AlphaMask& rAlpha,
1357 const Point& rDestPt,
1358 const Size& rDestSize,
1359 const Point& rSrcPtPixel,
1360 const Size& rSrcSizePixel );
1361
1362 SAL_DLLPRIVATE Bitmap BlendBitmap(
1363 Bitmap& aBmp,
1364 BitmapReadAccess* pP,
1365 BitmapReadAccess* pA,
1366 const sal_Int32 nOffY,
1367 const sal_Int32 nDstHeight,
1368 const sal_Int32 nOffX,
1369 const sal_Int32 nDstWidth,
1370 const Rectangle& aBmpRect,
1371 const Size& aOutSz,
1372 const bool bHMirr,
1373 const bool bVMirr,
1374 const long* pMapX,
1375 const long* pMapY );
1376
1377 SAL_DLLPRIVATE Bitmap BlendBitmapWithAlpha(
1378 Bitmap& aBmp,
1379 BitmapReadAccess* pP,
1380 BitmapReadAccess* pA,
1381 const Rectangle& aDstRect,
1382 const sal_Int32 nOffY,
1383 const sal_Int32 nDstHeight,
1384 const sal_Int32 nOffX,
1385 const sal_Int32 nDstWidth,
1386 const long* pMapX,
1387 const long* pMapY );
1388
1389 /** Retrieve downsampled and cropped bitmap
1390
1391 @attention This method ignores negative rDstSz values, thus
1392 mirroring must happen outside this method (e.g. in DrawBitmap)
1393 */
1394 SAL_DLLPRIVATE Bitmap GetDownsampledBitmap(
1395 const Size& rDstSz,
1396 const Point& rSrcPt,
1397 const Size& rSrcSz,
1398 const Bitmap& rBmp,
1399 long nMaxBmpDPIX,
1400 long nMaxBmpDPIY );
1401
1402 ///@}
1403
1404
1405 /** @name Transparency functions
1406 */
1407 ///@{
1408
1409 public:
1410
1411 /** Query availability of alpha channel
1412
1413 @return sal_True, if this device has an alpha channel.
1414 */
1415 bool HasAlpha();
1416
1417
1418 /** helper method removing transparencies from a metafile (e.g. for printing)
1419
1420 @returns
1421 true: transparencies were removed
1422 false: output metafile is unchanged input metafile
1423
1424 @attention this is a member method, so current state can influence the result !
1425 @attention the output metafile is prepared in pixel mode for the currentOutputDevice
1426 state. It can not be moved or rotated reliably anymore.
1427 */
1428 bool RemoveTransparenciesFromMetaFile(
1429 const GDIMetaFile& rInMtf, GDIMetaFile& rOutMtf,
1430 long nMaxBmpDPIX, long nMaxBmpDPIY,
1431 bool bReduceTransparency,
1432 bool bTransparencyAutoMode,
1433 bool bDownsampleBitmaps,
1434 const Color& rBackground = Color( COL_TRANSPARENT ) );
1435
1436 SAL_DLLPRIVATE void ImplPrintTransparent (
1437 const Bitmap& rBmp, const Bitmap& rMask,
1438 const Point& rDestPt, const Size& rDestSize,
1439 const Point& rSrcPtPixel, const Size& rSrcSizePixel );
1440
1441 SAL_DLLPRIVATE Color ImplDrawModeToColor ( const Color& rColor ) const;
1442
1443
1444 /** Query the existence and depth of the alpha channel
1445
1446 @return 0, if no alpha channel available, and the bit depth of
1447 the alpha channel otherwise.
1448 */
1449 virtual sal_uInt16 GetAlphaBitCount() const;
1450
1451
1452 void DrawTransparent( const PolyPolygon& rPolyPoly, sal_uInt16 nTransparencePercent );
1453 void DrawTransparent( const basegfx::B2DPolyPolygon& rB2DPolyPoly, double fTransparency);
1454 void DrawTransparent(
1455 const GDIMetaFile& rMtf, const Point& rPos, const Size& rSize,
1456 const Gradient& rTransparenceGradient );
1457
1458 protected:
1459
1460 virtual void EmulateDrawTransparent( const PolyPolygon& rPolyPoly, sal_uInt16 nTransparencePercent );
1461 void DrawInvisiblePolygon( const PolyPolygon& rPolyPoly );
1462
1463 private:
1464
1465 SAL_DLLPRIVATE bool DrawTransparentNatively( const PolyPolygon& rPolyPoly, sal_uInt16 nTransparencePercent );
1466 ///@}
1467
1468
1469 /** @name Mask functions
1470 */
1471 ///@{
1472
1473 public:
1474
1475 void DrawMask( const Point& rDestPt,
1476 const Bitmap& rBitmap, const Color& rMaskColor );
1477
1478 void DrawMask( const Point& rDestPt, const Size& rDestSize,
1479 const Bitmap& rBitmap, const Color& rMaskColor );
1480
1481 void DrawMask( const Point& rDestPt, const Size& rDestSize,
1482 const Point& rSrcPtPixel, const Size& rSrcSizePixel,
1483 const Bitmap& rBitmap, const Color& rMaskColor,
1484 sal_uLong nAction );
1485
1486 protected:
1487
1488 virtual void DrawDeviceMask (
1489 const Bitmap& rMask, const Color& rMaskColor,
1490 const Point& rDestPt, const Size& rDestSize,
1491 const Point& rSrcPtPixel, const Size& rSrcSizePixel );
1492 ///@}
1493
1494
1495 /** @name Map functions
1496 */
1497 ///@{
1498
1499 public:
1500
1501 void EnableMapMode( bool bEnable = true );
1502 bool IsMapModeEnabled() const { return mbMap; }
1503
1504 virtual void SetMapMode();
1505 virtual void SetMapMode( const MapMode& rNewMapMode );
1506 virtual void SetRelativeMapMode( const MapMode& rNewMapMode );
1507 const MapMode& GetMapMode() const { return maMapMode; }
1508 bool IsMapMode() const { return mbMap; }
1509
1510 // #i75163#
1511 basegfx::B2DHomMatrix GetViewTransformation() const;
1512 basegfx::B2DHomMatrix GetInverseViewTransformation() const;
1513
1514 basegfx::B2DHomMatrix GetViewTransformation( const MapMode& rMapMode ) const;
1515 basegfx::B2DHomMatrix GetInverseViewTransformation( const MapMode& rMapMode ) const;
1516
1517
1518 /** Set an offset in pixel
1519
1520 This method offsets every drawing operation that converts its
1521 coordinates to pixel by the given value. Normally, the effect
1522 can be achieved by setting a MapMode with a different
1523 origin. Unfortunately, this origin is in logical coordinates
1524 and can lead to rounding errors (see #102532# for details).
1525
1526 @attention This offset is only applied when converting to
1527 pixel, i.e. some output modes such as metafile recordings
1528 might be completely unaffected by this method! Use with
1529 care. Furthermore, if the OutputDevice's MapMode is the
1530 default (that's MAP_PIXEL), then any pixel offset set is
1531 ignored also. This might be unintuitive for cases, but would
1532 have been far more fragile to implement. What's more, the
1533 reason why the pixel offset was introduced (avoiding rounding
1534 errors) does not apply for MAP_PIXEL, because one can always
1535 use the MapMode origin then.
1536
1537 @param rOffset
1538 The offset in pixel
1539 */
1540 void SetPixelOffset( const Size& rOffset );
1541
1542 /** Get the offset in pixel
1543
1544 @see OutputDevice::SetPixelOffset for details
1545
1546 @return the current offset in pixel
1547 */
1548 Size GetPixelOffset() const;
1549
1550 Point LogicToPixel( const Point& rLogicPt ) const;
1551 Size LogicToPixel( const Size& rLogicSize ) const;
1552 Rectangle LogicToPixel( const Rectangle& rLogicRect ) const;
1553 Polygon LogicToPixel( const Polygon& rLogicPoly ) const;
1554 PolyPolygon LogicToPixel( const PolyPolygon& rLogicPolyPoly ) const;
1555 basegfx::B2DPolyPolygon LogicToPixel( const basegfx::B2DPolyPolygon& rLogicPolyPoly ) const;
1556 Region LogicToPixel( const Region& rLogicRegion )const;
1557 Point LogicToPixel( const Point& rLogicPt,
1558 const MapMode& rMapMode ) const;
1559 Size LogicToPixel( const Size& rLogicSize,
1560 const MapMode& rMapMode ) const;
1561 Rectangle LogicToPixel( const Rectangle& rLogicRect,
1562 const MapMode& rMapMode ) const;
1563 Polygon LogicToPixel( const Polygon& rLogicPoly,
1564 const MapMode& rMapMode ) const;
1565 basegfx::B2DPolygon LogicToPixel( const basegfx::B2DPolygon& rLogicPoly,
1566 const MapMode& rMapMode ) const;
1567 PolyPolygon LogicToPixel( const PolyPolygon& rLogicPolyPoly,
1568 const MapMode& rMapMode ) const;
1569 basegfx::B2DPolyPolygon LogicToPixel( const basegfx::B2DPolyPolygon& rLogicPolyPoly,
1570 const MapMode& rMapMode ) const;
1571 Region LogicToPixel( const Region& rLogicRegion,
1572 const MapMode& rMapMode ) const;
1573 basegfx::B2DPolygon LogicToPixel( const basegfx::B2DPolygon& rLogicPoly ) const;
1574
1575 Point PixelToLogic( const Point& rDevicePt ) const;
1576 Size PixelToLogic( const Size& rDeviceSize ) const;
1577 Rectangle PixelToLogic( const Rectangle& rDeviceRect ) const;
1578 Polygon PixelToLogic( const Polygon& rDevicePoly ) const;
1579 PolyPolygon PixelToLogic( const PolyPolygon& rDevicePolyPoly ) const;
1580 basegfx::B2DPolyPolygon PixelToLogic( const basegfx::B2DPolyPolygon& rDevicePolyPoly ) const;
1581 Region PixelToLogic( const Region& rDeviceRegion ) const;
1582 Point PixelToLogic( const Point& rDevicePt,
1583 const MapMode& rMapMode ) const;
1584 Size PixelToLogic( const Size& rDeviceSize,
1585 const MapMode& rMapMode ) const;
1586 Rectangle PixelToLogic( const Rectangle& rDeviceRect,
1587 const MapMode& rMapMode ) const;
1588 Polygon PixelToLogic( const Polygon& rDevicePoly,
1589 const MapMode& rMapMode ) const;
1590 basegfx::B2DPolygon PixelToLogic( const basegfx::B2DPolygon& rDevicePoly,
1591 const MapMode& rMapMode ) const;
1592 PolyPolygon PixelToLogic( const PolyPolygon& rDevicePolyPoly,
1593 const MapMode& rMapMode ) const;
1594 basegfx::B2DPolyPolygon PixelToLogic( const basegfx::B2DPolyPolygon& rDevicePolyPoly,
1595 const MapMode& rMapMode ) const;
1596 Region PixelToLogic( const Region& rDeviceRegion,
1597 const MapMode& rMapMode ) const;
1598
1599 Point LogicToLogic( const Point& rPtSource,
1600 const MapMode* pMapModeSource,
1601 const MapMode* pMapModeDest ) const;
1602 Size LogicToLogic( const Size& rSzSource,
1603 const MapMode* pMapModeSource,
1604 const MapMode* pMapModeDest ) const;
1605 Rectangle LogicToLogic( const Rectangle& rRectSource,
1606 const MapMode* pMapModeSource,
1607 const MapMode* pMapModeDest ) const;
1608 static Point LogicToLogic( const Point& rPtSource,
1609 const MapMode& rMapModeSource,
1610 const MapMode& rMapModeDest );
1611 static Size LogicToLogic( const Size& rSzSource,
1612 const MapMode& rMapModeSource,
1613 const MapMode& rMapModeDest );
1614 static Rectangle LogicToLogic( const Rectangle& rRectSource,
1615 const MapMode& rMapModeSource,
1616 const MapMode& rMapModeDest );
1617 static long LogicToLogic( long nLongSource,
1618 MapUnit eUnitSource,
1619 MapUnit eUnitDest );
1620
1621 static basegfx::B2DPolygon LogicToLogic( const basegfx::B2DPolygon& rPoly,
1622 const MapMode& rMapModeSource,
1623 const MapMode& rMapModeDest );
1624 static basegfx::B2DPolyPolygon LogicToLogic( const basegfx::B2DPolyPolygon& rPolyPoly,
1625 const MapMode& rMapModeSource,
1626 const MapMode& rMapModeDest );
1627
1628 // create a mapping transformation from rMapModeSource to rMapModeDest (the above methods
1629 // for B2DPoly/Polygons use this internally anyway to transform the B2DPolygon)
1630 static basegfx::B2DHomMatrix LogicToLogic(const MapMode& rMapModeSource, const MapMode& rMapModeDest);
1631
1632 /** Convert a logical rectangle to a rectangle in physical device pixel units.
1633
1634 @param rLogicSize Const reference to a rectangle in logical units
1635
1636 @returns Rectangle based on physical device pixel coordinates and units.
1637 */
1638 SAL_DLLPRIVATE Rectangle ImplLogicToDevicePixel( const Rectangle& rLogicRect ) const;
1639
1640 /** Convert a logical point to a physical point on the device.
1641
1642 @param rLogicPt Const reference to a point in logical units.
1643
1644 @returns Physical point on the device.
1645 */
1646 SAL_DLLPRIVATE Point ImplLogicToDevicePixel( const Point& rLogicPt ) const;
1647
1648 /** Convert a logical width to a width in units of device pixels.
1649
1650 To get the number of device pixels, it must calculate the X-DPI of the device and
1651 the map scaling factor. If there is no mapping, then it just returns the
1652 width as nothing more needs to be done.
1653
1654 @param nWidth Logical width
1655
1656 @returns Width in units of device pixels.
1657 */
1658 SAL_DLLPRIVATE long ImplLogicWidthToDevicePixel( long nWidth ) const;
1659
1660 private:
1661
1662 /** Convert a logical X coordinate to a device pixel's X coordinate.
1663
1664 To get the device's X coordinate, it must calculate the mapping offset
1665 coordinate X position (if there is one - if not then it just adds
1666 the pseudo-window offset to the logical X coordinate), the X-DPI of
1667 the device and the mapping's X scaling factor.
1668
1669 @param nX Logical X coordinate
1670
1671 @returns Device's X pixel coordinate
1672 */
1673 SAL_DLLPRIVATE long ImplLogicXToDevicePixel( long nX ) const;
1674
1675 /** Convert a logical Y coordinate to a device pixel's Y coordinate.
1676
1677 To get the device's Y coordinate, it must calculate the mapping offset
1678 coordinate Y position (if there is one - if not then it just adds
1679 the pseudo-window offset to the logical Y coordinate), the Y-DPI of
1680 the device and the mapping's Y scaling factor.
1681
1682 @param nY Logical Y coordinate
1683
1684 @returns Device's Y pixel coordinate
1685 */
1686 SAL_DLLPRIVATE long ImplLogicYToDevicePixel( long nY ) const;
1687
1688 /** Convert a logical height to a height in units of device pixels.
1689
1690 To get the number of device pixels, it must calculate the Y-DPI of the device and
1691 the map scaling factor. If there is no mapping, then it just returns the
1692 height as nothing more needs to be done.
1693
1694 @param nHeight Logical height
1695
1696 @returns Height in units of device pixels.
1697 */
1698 SAL_DLLPRIVATE long ImplLogicHeightToDevicePixel( long nHeight ) const;
1699
1700 /** Convert device pixels to a width in logical units.
1701
1702 To get the logical width, it must calculate the X-DPI of the device and the
1703 map scaling factor.
1704
1705 @param nWidth Width in device pixels
1706
1707 @returns Width in logical units.
1708 */
1709 SAL_DLLPRIVATE long ImplDevicePixelToLogicWidth( long nWidth ) const;
1710
1711 /** Convert device pixels to a height in logical units.
1712
1713 To get the logical height, it must calculate the Y-DPI of the device and the
1714 map scaling factor.
1715
1716 @param nHeight Height in device pixels
1717
1718 @returns Height in logical units.
1719 */
1720 SAL_DLLPRIVATE long ImplDevicePixelToLogicHeight( long nHeight ) const;
1721
1722 /** Convert logical height to device pixels, with exact sub-pixel value.
1723
1724 To get the \em exact pixel height, it must calculate the Y-DPI of the device and the
1725 map scaling factor.
1726
1727 @param nHeight Exact height in logical units.
1728
1729 @returns Exact height in pixels - returns as a float to provide for subpixel value.
1730 */
1731 SAL_DLLPRIVATE float ImplFloatLogicHeightToDevicePixel( float ) const;
1732
1733 /** Convert a logical size to the size on the physical device.
1734
1735 @param rLogicSize Const reference to a size in logical units
1736
1737 @returns Physical size on the device.
1738 */
1739 SAL_DLLPRIVATE Size ImplLogicToDevicePixel( const Size& rLogicSize ) const;
1740
1741 /** Convert a rectangle in physical pixel units to a rectangle in physical pixel units and coords.
1742
1743 @param rPixelRect Const reference to rectangle in logical units and coords.
1744
1745 @returns Rectangle based on logical coordinates and units.
1746 */
1747 SAL_DLLPRIVATE Rectangle ImplDevicePixelToLogic( const Rectangle& rPixelRect ) const;
1748
1749 /** Convert a logical B2DPolygon to a B2DPolygon in physical device pixel units.
1750
1751 @param rLogicSize Const reference to a B2DPolygon in logical units
1752
1753 @returns B2DPolyPolygon based on physical device pixel coordinates and units.
1754 */
1755 SAL_DLLPRIVATE ::basegfx::B2DPolygon ImplLogicToDevicePixel( const ::basegfx::B2DPolygon& rLogicPoly ) const;
1756
1757 /** Convert a logical B2DPolyPolygon to a B2DPolyPolygon in physical device pixel units.
1758
1759 @param rLogicPolyPoly Const reference to a B2DPolyPolygon in logical units
1760
1761 @returns B2DPolyPolygon based on physical device pixel coordinates and units.
1762 */
1763 SAL_DLLPRIVATE ::basegfx::B2DPolyPolygon ImplLogicToDevicePixel( const ::basegfx::B2DPolyPolygon& rLogicPolyPoly ) const;
1764
1765 /** Convert a logical polygon to a polygon in physical device pixel units.
1766
1767 @param rLogicPoly Const reference to a polygon in logical units
1768
1769 @returns Polygon based on physical device pixel coordinates and units.
1770 */
1771 SAL_DLLPRIVATE Polygon ImplLogicToDevicePixel( const Polygon& rLogicPoly ) const;
1772
1773 /** Convert a logical polypolygon to a polypolygon in physical device pixel units.
1774
1775 @param rLogicPolyPoly Const reference to a polypolygon in logical units
1776
1777 @returns Polypolygon based on physical device pixel coordinates and units.
1778 */
1779 SAL_DLLPRIVATE PolyPolygon ImplLogicToDevicePixel( const PolyPolygon& rLogicPolyPoly ) const;
1780
1781 /** Convert a line in logical units to a line in physical device pixel units.
1782
1783 @param rLineInfo Const refernece to a line in logical units
1784
1785 @returns Line based on physical device pixel coordinates and units.
1786 */
1787 SAL_DLLPRIVATE LineInfo ImplLogicToDevicePixel( const LineInfo& rLineInfo ) const;
1788
1789 /** Convert a region in pixel units to a region in device pixel units and coords.
1790
1791 @param rPixelRect Const reference to region.
1792
1793 @returns Region based on device pixel coordinates and units.
1794 */
1795 SAL_DLLPRIVATE Region ImplPixelToDevicePixel( const Region& rRegion ) const;
1796
1797 /** Invalidate the view transformation.
1798
1799 @since AOO bug 75163 (OpenOffice.org 2.4.3 - OOH 680 milestone 212)
1800 */
1801 SAL_DLLPRIVATE void ImplInvalidateViewTransform();
1802
1803 /** Get device transformation.
1804
1805 @since AOO bug 75163 (OpenOffice.org 2.4.3 - OOH 680 milestone 212)
1806 */
1807 SAL_DLLPRIVATE basegfx::B2DHomMatrix ImplGetDeviceTransformation() const;
1808 ///@}
1809
1810
1811 /** @name Native Widget Rendering functions
1812
1813 These all just call through to the private mpGraphics functions of the same name.
1814 */
1815 ///@{
1816
1817 public:
1818
1819 /** Query the platform layer for control support
1820 */
1821 bool IsNativeControlSupported( ControlType nType, ControlPart nPart ) const;
1822
1823 /** Query the native control to determine if it was acted upon
1824 */
1825 bool HitTestNativeControl(
1826 ControlType nType,
1827 ControlPart nPart,
1828 const Rectangle& rControlRegion,
1829 const Point& aPos,
1830 bool& rIsInside ) const;
1831
1832 /** Request rendering of a particular control and/or part
1833 */
1834 bool DrawNativeControl(
1835 ControlType nType,
1836 ControlPart nPart,
1837 const Rectangle& rControlRegion,
1838 ControlState nState,
1839 const ImplControlValue& aValue,
1840 const OUString& aCaption );
1841
1842 /** Query the native control's actual drawing region (including adornment)
1843 */
1844 bool GetNativeControlRegion(
1845 ControlType nType,
1846 ControlPart nPart,
1847 const Rectangle& rControlRegion,
1848 ControlState nState,
1849 const ImplControlValue& aValue,
1850 const OUString& aCaption,
1851 Rectangle &rNativeBoundingRegion,
1852 Rectangle &rNativeContentRegion ) const;
1853 ///@}
1854
1855 /** @name EPS functions
1856 */
1857 ///@{
1858
1859 public:
1860
1861 /** @returns boolean value to see if EPS could be painted directly.
1862 Theoreticaly, handing over a matrix would be needed to handle
1863 painting rotated EPS files (e.g. contained in Metafiles). This
1864 would then need to be supported for Mac and PS printers, but
1865 that's too much for now, wrote \#i107046# for this */
1866 bool DrawEPS(
1867 const Point& rPt, const Size& rSz,
1868 const GfxLink& rGfxLink, GDIMetaFile* pSubst = NULL );
1869 ///@}
1870
1871 };
1872
1873 #endif // INCLUDED_VCL_OUTDEV_HXX
1874
1875 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
FREE OFFICE SUITE