office-gobmx/svx
Noel Grandin 2b17ec2175 uno:Sequence->std::vector in SmartTagMgr
Change-Id: I163f7d6c0f30ac2929df1cae202e695d21bb49fc
2015-12-03 13:57:23 +02:00
..
doc
inc loplugin:unusedfields various 2015-11-26 13:26:25 +02:00
qa
sdi tdf#95403 Add Outline button 2015-11-14 23:02:47 +00:00
source uno:Sequence->std::vector in SmartTagMgr 2015-12-03 13:57:23 +02:00
uiconfig/ui Revert "Flip buttons: Make the tooltip an uno command property" 2015-11-18 14:51:43 +01:00
util tdf#93837 Add UNO-based SmartTag menu controller 2015-11-26 08:19:23 +00:00
workben loplugin:stringconstant: elide explicit ctor usage (automatic rewrite) 2015-11-06 09:37:52 +01:00
AllLangResTarget_gal.mk
AllLangResTarget_ofa.mk
AllLangResTarget_svx.mk
CppunitTest_svx_unit.mk
Executable_gengal.mk Avoid mesa_headers on X11, also link with -lGL only where necesssary 2015-11-12 01:30:08 +02:00
Executable_pixelctl.mk There are no include files in solenv/inc 2015-03-19 21:42:39 +02:00
JunitTest_svx_unoapi.mk
Library_svx.mk tdf#93837 Add UNO-based SmartTag menu controller 2015-11-26 08:19:23 +00:00
Library_svxcore.mk Bin mesa_headers completely 2015-11-12 07:10:30 +02:00
Library_textconversiondlgs.mk
Makefile
Module_svx.mk gengal script calling gengal.bin is not needed on Mac 2015-11-27 15:43:37 +01:00
Package_gengal.mk
README More additions about SdrView / SdrModel. 2015-04-07 09:18:17 +02:00
UIConfig_svx.mk tdf#87702: Addition of Shadow sidebar tab 2015-07-08 15:32:57 +00:00

Contains graphics related helper code. Lots of the draw and impress code is in this shared library.

xoutdev
this is where a lot of wht work would happen to move to the canvas. (what does that mean?)

svdraw
transparent gradient stuff.

== SdrObject ==

The shapes you can see in LibreOffice (like rectangle, etc.) are SdrObjects.
They are declared as a hierarchy:

SdrObject <- SdrAttrObj <- E3dObject <- E3dCompoundObject <- E3dCubeObj
    ^ ^ ^             ^            ^              | | ^ ^
    | | |             |            |              | | | +--- E3dExtrudeObj
    | | |             |            |              | | +----- E3dLatheObj
    | | |             |            |              | +------- E3dPolygonObj
    | | |             |            |              +--------- E3dSphereObj
    | | |             |            +--- E3dScene...
    | | |             |
    | | |             +--- SdrTextObj <- SdrObjCustomShape...
    | | |                   ^ ^ ^ ^ ^
    | | |                   | | | | +--- SdrEdgeObj...
    | | |                   | | | +----- SdrMeasureObj...
    | | |                   | | +------- SdrPathObj...
    | | |                   | +--------- SdrRectObj...
    | | |                   +----------- SdrTableObj...
    | | +--- SdrObjGroup...
    | + ---- SdrPageObj...
    +------- SdrVirtObj...

The above is incomplete of course.

== SdrModel / SdrView ==

Copied from svdview.hxx:

  First of all the app creates a SdrModel.
  Then it opens a Win and creates a SdrView.
  ShowSdrPage() announces a page at SdrView.
  It's possible to show SdrView in any Wins at once.

  SdrView can show as many Wins as it wants at once. Pages are announced
  or checked out with the help of ShowSdrPage()/HideSdrPage(). For every announced
  page there is a SdrPageView instance in container aPages. If more than one page
  is showed, you have to pay attention that the offset parameter of ShowSdrPage()
  is conformed to the size of the page (to prevent overlapping of two pages).

SdrView itself is inherited from many objects in a chain of inheritance (all
that starts with SdrPaintView - that is itself inherited from few classes
too):

SdrPaintView <- SdrSnapView <- SdrMarkView <- SdrEditView <- SdrPolyEditView
                                                                   ^
  +----------------------------------------------------------------+
  |
  SdrGlueEditView <- SdrObjEditView <- SdrExchangeView <- SdrDragView
                                                                   ^
  +----------------------------------------------------------------+
  |
  SdrCreateView <- SdrView

From SdrView on, it is not flat, but a real hierarchy again.

== Drawing Layer / SdrObject(s) ==

See drawinglayer/README for general information about drawinglayer.

Below is the class diagram that comes from
http://www.openoffice.org/marketing/ooocon2006/presentations/wednesday_g11.odp,
slide number 6.

.------- Model --------------.      .------- View -----------------------------------------.
| SdrObject - ViewContact    | 1..* | ViewObjectContact       1..*                         |
|              getChild()    |------|    getPrimitiveList()  -----> Object(s) ---> SdrView |
|              getVOC()      |      |    getRecPrimitiveList()      Contact                |
|              getViewInd... |      |________|_____________________________________________|
| ...ependentPrimitiveList() |               |
|____________________________|            generates
                                             |           ______
                                             V          /      |
                                   .----------------------.    |
                                   | basePrimitive        |    |
                                   |   getRange()         |<---'
                                   |   getDecomposition() |
                                   |______________________|

For SdrObjects, there are own DrawingLayer primitives in
svx/source/sdr/primitive2d

The ViewContact / ViewObject / ViewObjectContact are in svx/source/sdr/contact
Decomposes the SdrObjects, and does all sort of operations on them.

[So far I haven't found a definition / concept what are supposed to be the
ViewContact / ViewObject / ViewObjectContact.  If you find that out, please
fix this README :-)]