svx: translation by Mike Whiteley and Noel Grandin

(with very few tweaks by the committer)

svx/inc/svx/obj3d.hxx

@@ -118,7 +118,7 @@ private:
  protected:
     virtual sdr::properties::BaseProperties* CreateObjectSpecificProperties();
 
-    E3dObjList                  maSubList;          // child objekts
+    E3dObjList                  maSubList;          // child objects
 
     basegfx::B3DRange           maLocalBoundVol;    // surrounding volume of the object (from the geometry generation)
     basegfx::B3DHomMatrix       maTransformation;   // local transformation

svx/inc/svx/sdrpagewindow.hxx

@@ -35,7 +35,7 @@
 #include <com/sun/star/awt/XControlContainer.hpp>
 #include <com/sun/star/util/XModeChangeListener.hpp>
 #include <cppuhelper/implbase4.hxx>
-#include <svx/svdtypes.hxx> // fuer SdrLayerID
+#include <svx/svdtypes.hxx> // for SdrLayerID
 #include <svl/svarray.hxx>
 #include <tools/contnr.hxx>
 #include <svx/sdrpagewindow.hxx>

svx/inc/svx/sdtakitm.hxx

@@ -43,48 +43,46 @@ enum SdrTextAniKind {SDRTEXTANI_NONE,
                      SDRTEXTANI_SLIDE};
 
 // - SDRTEXTANI_BLINK:
-//   Einfach nur Blinken. Direction und Amount ohne Wirkung.
-//   Frequenz siehe Delay, 0=0.5Hz (Delay=250).
-//   Count=Anzahl der blinker. 0=Endlos.
-//   StartInside: sal_False=beginnend mit Pause, sal_True=Beginnend mit Puls
-//   StopInside:  sal_False=Nach Count blinkern nicht sichtbar, sal_True=sichtbar
-//                (nur wenn Count!=0)
+//   Just blink.  Direction and Amount don't effect things.
+//   Frequency delay: 0 = 0.5Hz (Delay = 250).
+//   Count = number of blinks. (0 = forever)
+//   start inside: sal_False = begin with the blinker off, sal_True  = begin with the blinker on
+//   stop inside: sal_False = end with the blinker off, sal_True = end with the blinker on
+//                (Only if count! = 0)
 // - SDRTEXTANI_SCROLL:
-//   Schrift laeuft rein, laeuft vollstaendig durch. Wenn ganz verschwunden
-//   geht's wieder von vorne los.
-//   Delay in ms, Sonderfall Delay=0 wird auf 50ms defaulted (20Hz)
-//   Count=Durchlaufanzahl (0=Endlos)
-//   Direction: ist eben die Richtung in die gescrollt wird.
-//   StartInside: sal_False=Schrift wird auch beim ersten Durchlauf reingescrollt
-//                sal_True=Der linke Teil der Schrift steht beim ersten Durchlauf
-//                     bereits da (im sichtbaren "Scrollbereich")
-//   StopInside:  sal_False=Schrift wird auch beim letzten Durchlauf vollstaendig
-//                      rausgescrollt
-//                sal_True=Schrift wird beim letzten Durchlauf nicht rausgescrollt
-//                (nur wenn Count!=0)
-//   Amount: Schrittweite in logischen Einheiten. Negative Werte bedeuten
-//           Pixel statt log. Einheiten. Wenn Amount=0, dann wird auf
-//           1 Pixel defaulted.
+//   Text just scrolls all the way through, and starts over when it is done.
+//
+//   Delay in ms: (except delay = 0 means 50ms (20Hz) default)
+//   Count = number of passes (0 = go forever)
+//   Direction: the direction to scroll
+//   StartInside: sal_False = on the first pass, scroll the text in (not initially visible)
+//                sal_True = on the first pass, the left part of the text is already visible
+//                           in the scroll area before starting.
+//   StopInside: sal_False = on the last pass, scroll the text all the way out.
+//                sal_True = on the last pass, keep the right part of the text visible.
+//                (Only if count! = 0)
+//   Amount: Step size in logical units. Negative values = use Pixels instead
+//           of logical units. If Amount = 0, then default to 1 Pixel.
 // - SDRTEXTANI_ALTERNATE:
-//   Wie SDRTEXTANI_SCROLL, nur wird nicht gescrollt bis Schrift ganz
-//   verschwunden, sondern bis der letzte Teil vollstaendig sichtbar ist. Dann
-//   wird die Richtung umgekehrt und zuruekgescrollt.
-//   Count=Anzahl der Durchlaeufe=Anzahl der Richtungswechsel-1
-//   Bei Count=1 ist SDRTEXTANI_ALTERNATE also identisch mit SDRTEXTANI_SCROLL
-//   Direction ist die Startrichtung
-//   Alle andern Parameter wie SDRTEXTANI_SCROLL
+//   Like SDRTEXTANI_SCROLL, except don't scroll until all of the text is out,
+//        but just until the last part is visible.  Then, change direction and
+//        scroll the text the other way.
+//   Count = number of passes (number of direction changes minus 1)
+//        If count = 1, this is the same as SDRTEXTANI_SCROLL
+//   Direction = the starting direction.
+//   All Other Parameters: just like SDRTEXTANI_SCROLL
 // - SDRTEXTANI_SLIDE:
-//   Schrift wird nur reingeschoben bis zur Originalposition.
-//   -> also wie SCROLL mit StartInside=sal_False, StopInside=TRUE
-//   und Count=1. Count=0 wird als Count=1 interpretiert.
-//   Fuer jeden Count>1 wird der Text jedoch ruekwaerts wieder vollstaendig
-//   rausgeschoben (aehnlich wie ALTERNATE) und dann wieder reingeschoben.
-//   StopInside wird nicht ausgewertet, weil immer Inside gestoppt wird.
-//   StartInside wird nicht ausgewertet, weil immer Outside gestartet wird.
-//   Alle andern Parameter wie SDRTEXTANI_SCROLL
-// StartInside,StopInside: Bei sal_True ist die anfaengliche/entgueltige
-// Textposition abhaengig von der Textverankerung am Zeichenobjekt. Sie
-// entspricht der Textposition bei normalem Paint (ohne Laufschrift).
+//   Text will slide in to the original position.
+//   -> same as SCROLL with StartInside = sal_False, StopInside = sal_True
+//   and Count = 1 (Count = 0 is interpreted as count = 1).
+//   For each count > 1, the text, will be slid out backwards
+//   (much like ALTERNATE) and then slid back in again.
+//   StopInside is not evaluated, because inside is always stopped.
+//   StartInside is not evaluated, because outside is always started.
+//   All other parameters are like SDRTEXTANI_SCROLL
+// StartInside, StopInside: When sal_True, the starting / final position
+//   of the text depends on the anchor of the drawing object.  This
+//   corresponds to the position of the text in normal Paint (without scrolling).
 
 class SVX_DLLPUBLIC SdrTextAniKindItem: public SfxEnumItem {
 public:

svx/inc/svx/sdynitm.hxx

@@ -34,9 +34,9 @@
 
 //------------------------------------------------------------
 // class SdrYesNoItem
-// hier liefert GetValueTextByVal() "ja" oder "nein"
-// anstelle von "TRUE" und "FALSE"
-//------------------------------------------------------------
+// GetValueTextByVal() returns "yes" or "no"
+// instead of "TRUE" and "FALSE"
+//-------------------------------------------------- ----------
 class SVX_DLLPUBLIC SdrYesNoItem: public SfxBoolItem {
 public:
     TYPEINFO();

svx/inc/svx/sphere3d.hxx

@@ -54,12 +54,12 @@ public:
     TYPEINFO();
     E3dSphereObj(E3dDefaultAttributes& rDefault, const basegfx::B3DPoint& rCenter, const basegfx::B3DVector& r3DSize);
 
-    // FG: Dieser Konstruktor wird nur von MakeObject aus der 3d-Objectfactory beim
-    //     Laden von Dokumenten mit Kugeln aufgerufen. Dieser Konstruktor ruft kein
-    //     CreateSphere auf, er erzeugt also keine Kugel.
+    // FG: This constructor is only called from MakeObject from the 3d-Objectfactory
+    //     when a document with a sphere is loaded.  This constructor does not call
+    //     CreateSphere, or create any spheres.
     E3dSphereObj(int dummy);
 
-    // HorizontalSegments:
+    // horizontal segments:
     sal_uInt32 GetHorizontalSegments() const
         { return ((const Svx3DHorizontalSegmentsItem&)GetObjectItemSet().Get(SDRATTR_3DOBJ_HORZ_SEGS)).GetValue(); }
 
@@ -75,11 +75,11 @@ public:
     const basegfx::B3DPoint& Center() const { return aCenter; }
     const basegfx::B3DVector& Size() const { return aSize; }
 
-    // Lokale Parameter setzen mit Geometrieneuerzeugung
+    // set local parameters when the geometry is recreated
     void SetCenter(const basegfx::B3DPoint& rNew);
     void SetSize(const basegfx::B3DVector& rNew);
 
-    // TakeObjName...() ist fuer die Anzeige in der UI, z.B. "3 Rahmen selektiert".
+    // TakeObjName...() is for displaying in the UI, eg "3 selected frames."
     virtual void TakeObjNameSingul(String& rName) const;
     virtual void TakeObjNamePlural(String& rName) const;
 };

svx/inc/svx/svdcrtv.hxx

@@ -62,8 +62,8 @@ class SVX_DLLPUBLIC SdrCreateView: public SdrDragView
     friend class                SdrPageView;
 
 protected:
-    SdrObject*                  pAktCreate;   // Aktuell in Erzeugung befindliches Objekt
-    SdrPageView*                pCreatePV;    // Hier wurde die Erzeugung gestartet
+    SdrObject*                  pAktCreate;   // Currently in creation of the located object
+    SdrPageView*                pCreatePV;    // Here, the creation is started
     ImplConnectMarkerOverlay*   mpCoMaOverlay;
 
     // for migrating stuff from XOR, use ImpSdrCreateViewExtraData ATM to not need to
@@ -74,10 +74,10 @@ protected:
 
     sal_Int32                       nAutoCloseDistPix;
     sal_Int32                       nFreeHandMinDistPix;
-    sal_uInt32                      nAktInvent;     // Aktuell eingestelltes
-    sal_uInt16                      nAktIdent;      // Obj fuer Neuerzeugung
+    sal_uInt32                      nAktInvent;     // set the current ones
+    sal_uInt16                      nAktIdent;      // Obj for re-creating
 
-    unsigned                    bAutoTextEdit : 1; // Textedit nach dem erzeugen eines Textrahmens starten
+    unsigned                    bAutoTextEdit : 1; // Textedit after we start the creation of a text frame
     unsigned                    b1stPointAsCenter : 1;
     unsigned                    bUseIncompatiblePathCreateInterface : 1;
     unsigned                    bAutoClosePolys : 1;
@@ -116,20 +116,20 @@ public:
     void SetMeasureLayer(const String& rName) { aMeasureLayer=rName; }
     const String& GetMeasureLayer() const { return aMeasureLayer; }
 
-    // Ist der MeasureLayer nicht gesetzt (Leerstring), so
-    // wird der ActiveLayer auch fuer Bemassung verwendet.
+    // If the MeasureLayer is not set (empty string), then
+    // use the active layer for measuring.
     void SetEditMode(SdrViewEditMode eMode) { SdrDragView::SetEditMode(eMode); CheckEdgeMode(); }
     void SetEditMode(sal_Bool bOn=sal_True) { SdrDragView::SetEditMode(bOn); CheckEdgeMode(); }
     void SetCreateMode(sal_Bool bOn=sal_True) { SdrDragView::SetCreateMode(bOn); CheckEdgeMode(); }
     void SetGluePointEditMode(sal_Bool bOn=sal_True) { SdrDragView::SetGluePointEditMode(bOn); CheckEdgeMode(); }
 
-    // Feststellen, ob Textwerkzeug aktiviert
+    // Determine whether a text tool is activated
     sal_Bool IsTextTool() const;
 
-    // Feststellen, ob Objektverbinderwerkzeug aktiviert
+    // Determine whether an object connector tool activated
     sal_Bool IsEdgeTool() const;
 
-    // Feststellen, ob Bemassungswerkzeug aktiviert
+    // Determine whether a measurement tool activated
     sal_Bool IsMeasureTool() const;
 
     void SetCurrentObj(sal_uInt16 nIdent, sal_uInt32 nInvent=SdrInventor);
@@ -142,35 +142,35 @@ public:
     sal_Bool BegCreatePreparedObject(const Point& rPnt, sal_Int16 nMinMov, SdrObject* pPreparedFactoryObject);
     void MovCreateObj(const Point& rPnt);
     sal_Bool EndCreateObj(SdrCreateCmd eCmd);
-    void BckCreateObj();  // z.B. wieder 1 Polygonpunkt zurueck.
+    void BckCreateObj();  // go back one polygon point
     void BrkCreateObj();
     sal_Bool IsCreateObj() const { return pAktCreate!=NULL; }
     SdrObject* GetCreateObj() const { return pAktCreate; }
 
-    // BegCreateCaptionObj() erzeugt ein SdrCaptionObj (Legendenobjekt).
-    // rObjSiz ist die anfaengliche Groesse des Legenden-Textrahmens.
-    // gedraggd wird lediglich die Laenge des Zipfel.
+    // BegCreateCaptionObj() creates a SdrCaptionObj (legend item).
+    // rObjSiz is the initial size of the legend text frame.
+    // only the length of the tip is dragged
     sal_Bool BegCreateCaptionObj(const Point& rPnt, const Size& rObjSiz, OutputDevice* pOut=NULL, short nMinMov=-3, SdrPageView* pPV=NULL);
 
-    // Wenn TextEditAfterCreate auf sal_True steht (das ist der Default),
-    // dann wird nach dem erzeugen eines Textrahmenobjekts (OBJ_TEXT,
+    // If TextEditAfterCreate is sal_True (the default),
+    // then after the creation of a TextFrame object (OBJ_TEXT,
     // OBJ_TEXTEXT, OBJ_OUTLINERTEXT, OBJ_TITLETEXT, OBJ_CAPTION)
-    // automatisch ein TextEdit (SdrObjEditView::SdrBeginTextEdit) gestartet.
+    // automatically start a TextEdit (SdrObjEditView: SdrBeginTextEdit)
     sal_Bool IsTextEditAfterCreate() const { return bAutoTextEdit; }
     void SetTextEditAfterCreate(sal_Bool bOn) { bAutoTextEdit = bOn; }
 
-    // Erzeugen eines Kreises/Rechtecks/Textrahmens wobei der 1. Punkt
-    // nicht die linke obere Ecke, sondern das Zentrum des Objekts vorgibt.
-    // Persistentes Flag. Default=FALSE.
+    // Create a circle / rectangle / text frame with the first Point being
+    // the center of the object instead of the upper-left corner.
+    // Persistent flag. Default = FALSE.
     sal_Bool IsCreate1stPointAsCenter() const { return b1stPointAsCenter; }
     void SetCreate1stPointAsCenter(sal_Bool bOn) { b1stPointAsCenter = bOn; }
 
-    // Fuer Polylines (OBJ_PLIN) und Freihandlinien (OBJ_FREELINE). Ist dieses
-    // Flag sal_True, werden diese beiden Objekttypen implizit geschlossen und in
-    // Polygon (OBJ_POLY) bzw. Freihandflaeche (OBJ_FREEFILL) gewandelt falls
-    // zum Ende des Create die Distanz zwischen Startpunkt und Endpunkt des
-    // Objekts <=n Pixel ist, wobei SetAutoCloseDistPix vorgegeben wird.
-    // Default=TRUE.
+    // For polylines (OBJ_PLIN) and freehand lines (OBJ_FREELINE). If this
+    // Flag is sal_True, these two types of objects are implicitly closed, and
+    // converted to Polygon (OBJ_POLY) or freehand fill (OBJ_FREEFILL) if
+    // the distance between the start point and end point of the
+    // Object <= nAutoCloseDistPix pixels.
+    // Default is TRUE.
     sal_Bool IsAutoClosePolys() const { return bAutoClosePolys; }
     void SetAutoClosePolys(sal_Bool bOn) { bAutoClosePolys=bOn; }
 

svx/inc/svx/svddef.hxx

@@ -167,7 +167,7 @@
 #define SDRATTR_CIRCENDANGLE            (SDRATTR_CIRC_FIRST+ 2)    /*   1174 */ /* Pool V4+ */
 #define SDRATTR_CIRC_LAST               (SDRATTR_CIRCENDANGLE)     /*   1178 */ /* Pool V4+ */
 
-// Nur fuer Interfaceing, not implemented yet.                     /*  V4+   */
+// Only for Interfaceing, not yet implemented. / * + * V4 /
 #define SDRATTR_NOTPERSIST_FIRST    (SDRATTR_CIRC_LAST + 1)          /* 1180   */ /* 1172   */ /* 1127   */ /* 1110   */ /* Pool V1: 1058 */
 #define SDRATTR_OBJMOVEPROTECT      (SDRATTR_NOTPERSIST_FIRST+ 0)  /*   1180  sal_Bool,   def=sal_False */
 #define SDRATTR_OBJSIZEPROTECT      (SDRATTR_NOTPERSIST_FIRST+ 1)  /*   1181  sal_Bool,   def=sal_False */
@@ -206,7 +206,7 @@
 #define SDRATTR_TEXTDIRECTION       (SDRATTR_NOTPERSIST_FIRST+34)  /*   1214 V4+++  long,   def=0     */
 #define SDRATTR_OBJVISIBLE          (SDRATTR_NOTPERSIST_FIRST+35)
 #define SDRATTR_NOTPERSIST_LAST     (SDRATTR_OBJVISIBLE)           /*   1228 V4+++*/ /* 1213*/  /*  1085 */ /*  1040 */ /*  1123 */ /* Pool V1: 1065 */
-// kein SetItem hierfuer
+// no SetItem for this
 
 #define SDRATTR_GRAF_FIRST          (SDRATTR_NOTPERSIST_LAST+1)     /*  1229 V4+++*/
 #define SDRATTR_GRAFRED             (SDRATTR_GRAF_FIRST+0)          /*  1229 V4+++*/

svx/inc/svx/svddrag.hxx

@@ -35,11 +35,11 @@
 #include <tools/fract.hxx>
 #include "svx/svxdllapi.h"
 
-// Statushalter fuer objektspeziefisches Draggen. Damit das Model
-// Statusfrei bleibt werden die Statusdaten an der View gehalten
-// und dem Objekt zu gegebener Zeit als Parameter uebergeben.
-// Ausserdem auch Statushalter fuer den Vorgang der Interaktiven
-// Objekterzeugung. pHdl ist in diesem Fall NULL.
+// Status information for specialized object dragging. In order for the model
+// to stay status free, the status data is kept on the View
+// and handed over to the object at the appropriate time as a parameter.
+// This also includes the status of the operation and Interactive
+// Object creation. In this case, pHdl is null.
 class SdrHdl;
 class SdrView;
 class SdrPageView;
@@ -84,14 +84,14 @@ protected:
     void*     aReservePtr3;
     void*     aReservePtr4;
 
-    bool      bShown;    // Xor sichrbar?
-    sal_uInt16    nMinMov;   // Soviel muss erstmal minimal bewegt werden
-    bool      bMinMoved; // MinMove durchbrochen?
+    bool      bShown;    // Xor visible?
+    sal_uInt16    nMinMov;   // So much has to be minimally moved first
+    bool      bMinMoved; // MinMove surpassed?
 
-    bool      bHorFixed; // nur Vertikal draggen
-    bool      bVerFixed; // nur Horizontal draggen
-    bool      bWantNoSnap; // TRUE=Fuer die Entscheidung ob fuer pObj->MovCreate() NoSnapPos verwendet
-                          // werden soll. Entsprechend wird auch NoSnapPos in den Buffer geschrieben.
+    bool      bHorFixed; // Dragging only vertical
+    bool      bVerFixed; // Dragging only horizontal
+    bool      bWantNoSnap; // To decide if pObj-> MovCreate () should use NoSnapPos or not.
+                          // Therefore, NoSnapPos is written into the buffer.
     bool  bOrtho4;
     bool  bOrtho8;
 
@@ -144,27 +144,27 @@ public:
     bool         IsVerFixed() const                  { return bVerFixed; }
     void         SetVerFixed(bool bOn)               { bVerFixed=bOn; }
 
-    // Hier kann das Obj sagen: "Ich will keinen Koordinatenfang!"
-    // z.B. fuer den Winkel des Kreisbogen...
+    // Here, the object can say: "I do not want to snap to coordinates!"
+    // for example, the angle of the arc ...
     bool         IsNoSnap() const                     { return bWantNoSnap; }
     void         SetNoSnap(bool bOn = true)           { bWantNoSnap=bOn; }
 
-    // Und hier kann das Obj sagen welches Ortho (wenn ueberhaupt eins)
-    // sinnvoll auf ihm angewendet werden kann.
-    // Ortho4 bedeutet Ortho in 4 Richtungen (fuer Rect und Cirt)
+    // And here the Obj say which Ortho (if there is one)
+    // can be usefully applied to him.
+    // Ortho4 means Ortho in four directions (for Rect and CIRT)
     bool         IsOrtho4Possible() const             { return bOrtho4; }
     void         SetOrtho4Possible(bool bOn = true)   { bOrtho4=bOn; }
-    // Ortho8 bedeutet Ortho in 8 Richtungen (fuer Linien)
+    // Ortho8 means Ortho in 8 directions (for lines)
     bool         IsOrtho8Possible() const             { return bOrtho8; }
     void         SetOrtho8Possible(bool bOn = true)   { bOrtho8=bOn; }
 
-    // Wird vom gedraggten Objekt gesetzt
+    // Is set by an object that was dragged.
     bool         IsEndDragChangesAttributes() const    { return bEndDragChangesAttributes; }
     void         SetEndDragChangesAttributes(bool bOn) { bEndDragChangesAttributes=bOn; }
     bool         IsEndDragChangesGeoAndAttributes() const   { return bEndDragChangesGeoAndAttributes; }
     void         SetEndDragChangesGeoAndAttributes(bool bOn) { bEndDragChangesGeoAndAttributes=bOn; }
 
-    // Wird von der View gesetzt und kann vom Obj ausgewertet werden
+    // Is set by the view and can be evaluated by Obj
     bool         IsMouseDown() const                  { return !bMouseIsUp; }
     void         SetMouseDown(bool bDown)         { bMouseIsUp=!bDown; }
 
@@ -185,7 +185,7 @@ public:
     const Rectangle& GetActionRect() const             { return aActionRect; }
     void             SetActionRect(const Rectangle& rR) { aActionRect=rR; }
 
-    // Unter Beruecksichtigung von 1stPointAsCenter
+    // also considering 1stPointAsCenter
     void TakeCreateRect(Rectangle& rRect) const;
 };
 

svx/inc/svx/svddrgv.hxx

@@ -65,20 +65,20 @@ protected:
     SdrUndoGeoObj*              pInsPointUndo;
     Rectangle                   aDragLimit;
     XubString                   aInsPointUndoStr;
-    SdrMarkList                 aFollowingEdges; // Wenn Knoten gedraggd werden, sollen alle Kanten als Xor folgen
+    SdrMarkList                 aFollowingEdges; // If nodes are dragged, all edges should follow as Xor
     SdrHdlKind                  eDragHdl;
 
     sal_uIntPtr                     nDragXorPolyLimit;
     sal_uIntPtr                     nDragXorPointLimit;
     sal_uInt16                      nDetailedEdgeDraggingLimit;
 
-    unsigned                    bFramDrag : 1;        // z.Zt. FrameDrag
-    unsigned                    bDragSpecial : 1;     // z.Zt. Special Obj-Dragging
+    unsigned                    bFramDrag : 1;        // currently frame dragging
+    unsigned                    bDragSpecial : 1;     // currently Special Obj-dragging
     unsigned                    bMarkedHitMovesAlways : 1; // Persistent
-    unsigned                    bDragLimit : 1;      // Limit auf SnapRect statt BoundRect
-    unsigned                    bDragHdl : 1;        // TRUE: RefPt wird verschoben
+    unsigned                    bDragLimit : 1;      // Limit on SnapRect instead of BoundRect
+    unsigned                    bDragHdl : 1;        // TRUE: RefPt is slid
     unsigned                    bDragStripes : 1;    // Persistent
-    unsigned                    bMirrRefDragObj : 1; // Persistent - Waehrend des Draggens der Spiegelachse die gespiegelten Objekte als Xor zeigen
+    unsigned                    bMirrRefDragObj : 1; // Persistent - During the drag, show the mirror axis of the mirrored objects as Xor
     unsigned                    mbSolidDragging : 1;  // allow solid create/drag of objects
     unsigned                    bMouseHideWhileDraggingPoints : 1;
     unsigned                    bResizeAtCenter : 1;