fdo#39468 Translate German comments - vcl/win/source/gdi/

Change-Id: I273bab015f96128ab5128ade3b8e0c69b0ef730e
Reviewed-on: https://gerrit.libreoffice.org/2937
Reviewed-by: Thomas Arnhold <thomas@arnhold.org>
Tested-by: Thomas Arnhold <thomas@arnhold.org>

4 files changed, 47 insertions, 54 deletions

diff --git a/vcl/win/source/gdi/salgdi.cxx b/vcl/win/source/gdi/salgdi.cxx
index 80bf5ab4c987..4ac1f4b983a5 100644
--- a/vcl/win/source/gdi/salgdi.cxx
+++ b/vcl/win/source/gdi/salgdi.cxx
@@ -125,9 +125,9 @@ static BYTE aOrdDither16Bit[8][8] =
 
 // =======================================================================
 
-// Pens muessen wir mit 1 Pixel-Breite erzeugen, da ansonsten die S3-Karte
-// viele Paintprobleme hat, wenn Polygone/PolyLines gezeichnet werden und
-// eine komplexe ClipRegion gesetzt ist
+// we must create pens with 1-pixel width; otherwise the S3-graphics card
+// map has many paint problems when drawing polygons/polyLines and a
+// complex is set
 #define GSL_PEN_WIDTH                   1
 
 // =======================================================================
@@ -327,14 +327,14 @@ void ImplFreeSalGDI()
     for ( i = 0; i < pSalData->mnStockBrushCount; i++ )
         DeleteBrush( pSalData->mhStockBrushAry[i] );
 
-    // 50% Brush loeschen
+    // delete 50% Brush
     if ( pSalData->mh50Brush )
     {
         DeleteBrush( pSalData->mh50Brush );
         pSalData->mh50Brush = 0;
     }
 
-    // 50% Bitmap loeschen
+    // delete 50% Bitmap
     if ( pSalData->mh50Bmp )
     {
         DeleteBitmap( pSalData->mh50Bmp );
@@ -344,7 +344,7 @@ void ImplFreeSalGDI()
     ImplClearHDCCache( pSalData );
     delete[] pSalData->mpHDCCache;
 
-    // Ditherpalette loeschen, wenn vorhanden
+    // delete Ditherpalette, if existing
     if ( pSalData->mhDitherPal )
     {
         DeleteObject( pSalData->mhDitherPal );
@@ -513,7 +513,7 @@ static SalColor ImplGetROPSalColor( SalROPColor nROPColor )
 
 void ImplSalInitGraphics( WinSalGraphics* pData )
 {
-    // Beim Printer berechnen wir die minimale Linienstaerke
+    // calculate the minimal line width for the printer
     if ( pData->mbPrinter )
     {
         int nDPIX = GetDeviceCaps( pData->mhDC, LOGPIXELSX );
@@ -554,7 +554,7 @@ HDC ImplGetCachedDC( sal_uLong nID, HBITMAP hBmp )
     {
         HDC hDC = GetDC( 0 );
 
-        // neuen DC mit DefaultBitmap anlegen
+        // create new DC sith DefaultBitmap
         pC->mhDC = CreateCompatibleDC( hDC );
 
         if( pSalData->mhDitherPal )
@@ -750,7 +750,7 @@ WinSalGraphics::WinSalGraphics()
 
 WinSalGraphics::~WinSalGraphics()
 {
-    // free obsolete GDI objekts
+    // free obsolete GDI objects
         ReleaseFonts();
 
     if ( mhPen )
@@ -770,7 +770,7 @@ WinSalGraphics::~WinSalGraphics()
         mhRegion = 0;
     }
 
-    // Cache-Daten zerstoeren
+    // delete cache data
     if ( mpStdClipRgnData )
         delete [] mpStdClipRgnData;
 
@@ -996,7 +996,7 @@ void WinSalGraphics::SetLineColor()
     HPEN hNewPen = GetStockPen( NULL_PEN );
     HPEN hOldPen = SelectPen( mhDC, hNewPen );
 
-    // destory or save old pen
+    // destroy or save old pen
     if ( mhPen )
     {
         if ( !mbStockPen )
@@ -1054,7 +1054,7 @@ void WinSalGraphics::SetLineColor( SalColor nSalColor )
     // select new pen
     HPEN hOldPen = SelectPen( mhDC, hNewPen );
 
-    // destory or save old pen
+    // destroy or save old pen
     if ( mhPen )
     {
         if ( !mbStockPen )
@@ -1078,7 +1078,7 @@ void WinSalGraphics::SetFillColor()
     HBRUSH hNewBrush = GetStockBrush( NULL_BRUSH );
     HBRUSH hOldBrush = SelectBrush( mhDC, hNewBrush );
 
-    // destory or save old brush
+    // destroy or save old brush
     if ( mhBrush )
     {
         if ( !mbStockBrush )
@@ -1182,7 +1182,7 @@ void WinSalGraphics::SetFillColor( SalColor nSalColor )
     // select new brush
     HBRUSH hOldBrush = SelectBrush( mhDC, hNewBrush );
 
-    // destory or save old brush
+    // destroy or save old brush
     if ( mhBrush )
     {
         if ( !mbStockBrush )
@@ -1332,7 +1332,7 @@ void WinSalGraphics::drawRect( long nX, long nY, long nWidth, long nHeight )
 
 void WinSalGraphics::drawPolyLine( sal_uLong nPoints, const SalPoint* pPtAry )
 {
-    // Unter NT koennen wir das Array direkt weiterreichen
+    // for NT, we can handover the array directly
     DBG_ASSERT( sizeof( POINT ) == sizeof( SalPoint ),
                 "WinSalGraphics::DrawPolyLine(): POINT != SalPoint" );
 
@@ -1358,8 +1358,7 @@ void WinSalGraphics::drawPolyLine( sal_uLong nPoints, const SalPoint* pPtAry )
             pWinPtAry[nPoints-1].x--;
     }
 
-    // Wegen Windows 95 und der Beschraenkung auf eine maximale Anzahl
-    // von Punkten
+    // for Windows 95 and its maximum number of points
     if ( !Polyline( mhDC, pWinPtAry, (int)nPoints ) && (nPoints > MAX_64KSALPOINTS) )
         Polyline( mhDC, pWinPtAry, MAX_64KSALPOINTS );
 
@@ -1382,13 +1381,12 @@ void WinSalGraphics::drawPolyLine( sal_uLong nPoints, const SalPoint* pPtAry )
 
 void WinSalGraphics::drawPolygon( sal_uLong nPoints, const SalPoint* pPtAry )
 {
-    // Unter NT koennen wir das Array direkt weiterreichen
+    // for NT, we can handover the array directly
     DBG_ASSERT( sizeof( POINT ) == sizeof( SalPoint ),
                 "WinSalGraphics::DrawPolygon(): POINT != SalPoint" );
 
     POINT* pWinPtAry = (POINT*)pPtAry;
-    // Wegen Windows 95 und der Beschraenkung auf eine maximale Anzahl
-    // von Punkten
+    // for Windows 95 and its maximum number of points
     if ( !WIN_Polygon( mhDC, pWinPtAry, (int)nPoints ) && (nPoints > MAX_64KSALPOINTS) )
         WIN_Polygon( mhDC, pWinPtAry, MAX_64KSALPOINTS );
 }
@@ -1422,8 +1420,8 @@ void WinSalGraphics::drawPolyPolygon( sal_uInt32 nPoly, const sal_uInt32* pPoint
         pWinPointAryAry = aWinPointAryAry;
     else
         pWinPointAryAry = new POINT[nPolyPolyPoints];
-    // Unter NT koennen wir das Array direkt weiterreichen
-    DBG_ASSERT( sizeof( POINT ) == sizeof( SalPoint ),
+    // for NT, we can handover the array directly
+   DBG_ASSERT( sizeof( POINT ) == sizeof( SalPoint ),
                 "WinSalGraphics::DrawPolyPolygon(): POINT != SalPoint" );
     const SalPoint* pPolyAry;
     UINT            n = 0;
@@ -1471,7 +1469,7 @@ void WinSalGraphics::drawPolyPolygon( sal_uInt32 nPoly, const sal_uInt32* pPoint
 sal_Bool WinSalGraphics::drawPolyLineBezier( sal_uLong nPoints, const SalPoint* pPtAry, const BYTE* pFlgAry )
 {
 #ifdef USE_GDI_BEZIERS
-    // Unter NT koennen wir das Array direkt weiterreichen
+    // for NT, we can handover the array directly
     DBG_ASSERT( sizeof( POINT ) == sizeof( SalPoint ),
                 "WinSalGraphics::DrawPolyLineBezier(): POINT != SalPoint" );
 
@@ -1488,7 +1486,7 @@ sal_Bool WinSalGraphics::drawPolyLineBezier( sal_uLong nPoints, const SalPoint*
 sal_Bool WinSalGraphics::drawPolygonBezier( sal_uLong nPoints, const SalPoint* pPtAry, const BYTE* pFlgAry )
 {
 #ifdef USE_GDI_BEZIERS
-    // Unter NT koennen wir das Array direkt weiterreichen
+    // for NT, we can handover the array directly
     DBG_ASSERT( sizeof( POINT ) == sizeof( SalPoint ),
                 "WinSalGraphics::DrawPolygonBezier(): POINT != SalPoint" );
 
@@ -1541,7 +1539,7 @@ sal_Bool WinSalGraphics::drawPolyPolygonBezier( sal_uInt32 nPoly, const sal_uInt
                                              const SalPoint* const* pPtAry, const BYTE* const* pFlgAry )
 {
 #ifdef USE_GDI_BEZIERS
-    // Unter NT koennen wir das Array direkt weiterreichen
+    // for NT, we can handover the array directly
     DBG_ASSERT( sizeof( POINT ) == sizeof( SalPoint ),
                 "WinSalGraphics::DrawPolyPolygonBezier(): POINT != SalPoint" );
 
diff --git a/vcl/win/source/gdi/salgdi2.cxx b/vcl/win/source/gdi/salgdi2.cxx
index 80d8dfb92ceb..3455c9c5e506 100644
--- a/vcl/win/source/gdi/salgdi2.cxx
+++ b/vcl/win/source/gdi/salgdi2.cxx
@@ -104,7 +104,7 @@ void ImplCalcOutSideRgn( const RECT& rSrcRect,
 {
     HRGN hTempRgn;
 
-    // Bereiche ausserhalb des sichtbaren Bereiches berechnen
+    // calculate area outside the visible region
     if ( rSrcRect.left < nLeft )
     {
         if ( !rhInvalidateRgn )
@@ -151,7 +151,7 @@ void WinSalGraphics::copyArea( long nDestX, long nDestY,
     int     nOldClipRgnType = ERROR;
     HRGN    hInvalidateRgn = 0;
 
-    // Muessen die ueberlappenden Bereiche auch invalidiert werden?
+    // do we have to invalidate also the overlaping regions?
     if ( (nFlags & SAL_COPYAREA_WINDOWINVALIDATE) && mbWindow )
     {
         // compute and invalidate those parts that were either off-screen or covered by other windows
@@ -188,7 +188,7 @@ void WinSalGraphics::copyArea( long nDestX, long nDestY,
             ImplSalGetWorkArea( NULL, &theScreen, NULL );  // find the screen area taking multiple monitors into account
             ImplCalcOutSideRgn( aSrcRect, theScreen.left, theScreen.top, theScreen.right, theScreen.bottom, hInvalidateRgn );
 
-            // Bereiche die von anderen Fenstern ueberlagert werden berechnen
+            // calculate regions that are covered by other windows
             HRGN hTempRgn2 = 0;
             HWND hWndTopWindow = mhWnd;
             // Find the TopLevel Window, because only Windows which are in
@@ -321,10 +321,9 @@ void WinSalGraphics::copyArea( long nDestX, long nDestY,
         if ( bInvalidate )
         {
             InvalidateRgn( mhWnd, hInvalidateRgn, TRUE );
-            // Hier loesen wir nur ein Update aus, wenn es der
-            // MainThread ist, damit es beim Bearbeiten der
-            // Paint-Message keinen Deadlock gibt, da der
-            // SolarMutex durch diesen Thread schon gelockt ist
+            // here we only initiate an update if this is the MainThread,
+            // so that there is no deadlock when handling the Paint event,
+            // as the SolarMutex is already held by this Thread
             SalData*    pSalData = GetSalData();
             DWORD       nCurThreadId = GetCurrentThreadId();
             if ( pSalData->mnAppThreadId == nCurThreadId )
@@ -542,9 +541,8 @@ void WinSalGraphics::drawBitmap( const SalTwoRect* pPosAry,
     aPosAry.mnDestX = aPosAry.mnDestY = 0;
     BitBlt( hMemDC, 0, 0, nDstWidth, nDstHeight, hDC, nDstX, nDstY, SRCCOPY );
 
-    // bei Paletten-Displays hat WIN/WNT offenbar ein kleines Problem,
-    // die Farben der Maske richtig auf die Palette abzubilden,
-    // wenn wir die DIB direkt ausgeben => DDB-Ausgabe
+    // WIN/WNT seems to have a minor problem mapping the correct color of the
+    // mask to the palette if we draw the DIB directly ==> draw DDB
     if( ( GetBitCount() <= 8 ) && rTransparentBitmap.ImplGethDIB() && rTransparentBitmap.GetBitCount() == 1 )
     {
         WinSalBitmap aTmp;
@@ -648,9 +646,8 @@ void WinSalGraphics::drawMask( const SalTwoRect* pPosAry,
     HBRUSH      hMaskBrush = CreateSolidBrush( RGB( cRed, cGreen, cBlue ) );
     HBRUSH      hOldBrush = SelectBrush( hDC, hMaskBrush );
 
-    // bei Paletten-Displays hat WIN/WNT offenbar ein kleines Problem,
-    // die Farben der Maske richtig auf die Palette abzubilden,
-    // wenn wir die DIB direkt ausgeben => DDB-Ausgabe
+    // WIN/WNT seems to have a minor problem mapping the correct color of the
+    // mask to the palette if we draw the DIB directly ==> draw DDB
     if( ( GetBitCount() <= 8 ) && rSalBitmap.ImplGethDIB() && rSalBitmap.GetBitCount() == 1 )
     {
         WinSalBitmap aTmp;
@@ -800,13 +797,12 @@ void WinSalGraphics::invert( sal_uLong nPoints, const SalPoint* pPtAry, SalInver
     hOldPen = SelectPen( mhDC, hPen );
 
     POINT* pWinPtAry;
-    // Unter NT koennen wir das Array direkt weiterreichen
+    // for NT, we can handover the array directly
     DBG_ASSERT( sizeof( POINT ) == sizeof( SalPoint ),
                 "WinSalGraphics::DrawPolyLine(): POINT != SalPoint" );
 
     pWinPtAry = (POINT*)pPtAry;
-    // Wegen Windows 95 und der Beschraenkung auf eine maximale Anzahl
-    // von Punkten
+    // for Windows 95 and its maximum number of points
     if ( nSalFlags & SAL_INVERT_TRACKFRAME )
     {
         if ( !Polyline( mhDC, pWinPtAry, (int)nPoints ) && (nPoints > MAX_64KSALPOINTS) )
diff --git a/vcl/win/source/gdi/salgdi3.cxx b/vcl/win/source/gdi/salgdi3.cxx
index f2bcd8e88f77..e80b8ab44e0f 100644
--- a/vcl/win/source/gdi/salgdi3.cxx
+++ b/vcl/win/source/gdi/salgdi3.cxx
@@ -799,7 +799,7 @@ inline FontPitch ImplLogPitchToSal( BYTE nPitch )
 
 inline FontPitch ImplMetricPitchToSal( BYTE nPitch )
 {
-    // Sausaecke bei MS !! siehe NT Hilfe
+    // Grrrr! See NT help
     if ( !(nPitch & TMPF_FIXED_PITCH) )
         return PITCH_FIXED;
     else
@@ -2269,8 +2269,8 @@ void WinSalGraphics::GetDevFontList( ImplDevFontList* pFontList )
     EnumFontFamiliesExW( mhDC, &aLogFont,
         (FONTENUMPROCW)SalEnumFontsProcExW, (LPARAM)(void*)&aInfo, 0 );
 
-    // Feststellen, was es fuer Courier-Schriften auf dem Bildschirm gibt,
-    // um in SetFont() evt. Courier auf Courier New zu mappen
+    // check what Courier fonts are used on the screen, so to perhaps
+    // map Courier to CourierNew in SetFont()
     if ( !mbPrinter )
     {
         bImplSalCourierScalable = aInfo.mbImplSalCourierScalable;
diff --git a/vcl/win/source/gdi/salprn.cxx b/vcl/win/source/gdi/salprn.cxx
index d1904a7b5a53..dda80b3ca9a6 100644
--- a/vcl/win/source/gdi/salprn.cxx
+++ b/vcl/win/source/gdi/salprn.cxx
@@ -403,7 +403,7 @@ static sal_Bool ImplUpdateSalJobSetup( WinSalInfoPrinter* pPrinter, ImplJobSetup
         return FALSE;
     }
 
-    // Outputbuffer anlegen
+    // make Outputbuffer
     nDriverDataLen              = sizeof(SalDriverData) + nSysJobSize-1;
     pOutBuffer                  = (SalDriverData*)rtl_allocateZeroMemory( nDriverDataLen );
     pOutBuffer->mnSysSignature  = SAL_DRIVERDATA_SYSSIGN;
@@ -412,14 +412,14 @@ static sal_Bool ImplUpdateSalJobSetup( WinSalInfoPrinter* pPrinter, ImplJobSetup
                                     (char*)pOutBuffer->maDriverData -
                                     (char*)pOutBuffer );
 
-    // Testen, ob wir einen geeigneten Inputbuffer haben
+    // check if we have a suitable input buffer
     if ( bIn && ImplTestSalJobSetup( pPrinter, pSetupData, FALSE ) )
     {
         pInBuffer = (BYTE*)pSetupData->mpDriverData + ((SalDriverData*)pSetupData->mpDriverData)->mnDriverOffset;
         nMode |= DM_IN_BUFFER;
     }
 
-    // Testen, ob Dialog angezeigt werden soll
+    // check if the dialog should be shown
     if ( pVisibleDlgParent )
     {
         hWnd = pVisibleDlgParent->mhWnd;
@@ -1571,14 +1571,13 @@ sal_Bool WinSalPrinter::StartJob( const rtl::OUString* pFileName,
     mnError = 0;
     mbAbort = FALSE;
 
-    // Wegen Telocom Balloon Fax-Treiber, der uns unsere Messages
-    // ansonsten oefters schickt, versuchen wir vorher alle
-    // zu verarbeiten und dann eine Dummy-Message reinstellen
+    // As the Telocom Balloon Fax driver tends to send messages repeatedly
+    // we try to process first all, and then insert a dummy message
     sal_Bool bWhile = TRUE;
     int  i = 0;
     do
     {
-        // Messages verarbeiten
+        // process messages
         MSG aMsg;
         if ( ImplPeekMessage( &aMsg, 0, 0, 0, PM_REMOVE ) )
         {
@@ -1689,7 +1688,7 @@ sal_Bool WinSalPrinter::AbortJob()
 {
     mbAbort = TRUE;
 
-    // Abort asyncron ausloesen
+    // trigger Abort asynchronously
     HDC hDC = mhDC;
     if ( hDC )
     {
@@ -1708,7 +1707,7 @@ void ImplSalPrinterAbortJobAsync( HDC hPrnDC )
     SalData*    pSalData = GetSalData();
     WinSalPrinter* pPrinter = pSalData->mpFirstPrinter;
 
-    // Feststellen, ob Printer noch existiert
+    // check if printer still exists
     while ( pPrinter )
     {
         if ( pPrinter->mhDC == hPrnDC )
@@ -1717,7 +1716,7 @@ void ImplSalPrinterAbortJobAsync( HDC hPrnDC )
         pPrinter = pPrinter->mpNextPrinter;
     }
 
-    // Wenn Printer noch existiert, dann den Job abbrechen
+    // if printer still exists, cancel the job
     if ( pPrinter )
     {
         HDC hDC = pPrinter->mhDC;