Mercurial > projects > dwt-mac
view dwt/printing/Printer.d @ 7:e831403a80a9
Add 'cast' to casts
author | Frank Benoit <benoit@tionex.de> |
---|---|
date | Wed, 27 Aug 2008 14:30:35 +0200 |
parents | 1a8b3cb347e0 |
children | db5a898b2119 |
line wrap: on
line source
/******************************************************************************* * Copyright (c) 2000, 2007 IBM Corporation and others. * All rights reserved. This program and the accompanying materials * are made available under the terms of the Eclipse Public License v1.0 * which accompanies this distribution, and is available at * http://www.eclipse.org/legal/epl-v10.html * * Contributors: * IBM Corporation - initial API and implementation *******************************************************************************/ module dwt.printing.Printer; import dwt.dwthelper.utils; import dwt.DWT; import dwt.DWTError; import dwt.DWTException; import dwt.graphics.Device; import dwt.graphics.DeviceData; import dwt.graphics.GCData; import dwt.graphics.Point; import dwt.graphics.Rectangle; import dwt.internal.cocoa.NSArray; import dwt.internal.cocoa.NSPrinter; import dwt.internal.cocoa.NSString; /** * Instances of this class are used to print to a printer. * Applications create a GC on a printer using <code>new GC(printer)</code> * and then draw on the printer GC using the usual graphics calls. * <p> * A <code>Printer</code> object may be constructed by providing * a <code>PrinterData</code> object which identifies the printer. * A <code>PrintDialog</code> presents a print dialog to the user * and returns an initialized instance of <code>PrinterData</code>. * Alternatively, calling <code>new Printer()</code> will construct a * printer object for the user's default printer. * </p><p> * Application code must explicitly invoke the <code>Printer.dispose()</code> * method to release the operating system resources managed by each instance * when those instances are no longer required. * </p> * * @see PrinterData * @see PrintDialog */ public final class Printer : Device { PrinterData data; NSPrinter printer; bool inPage, isGCCreated; static final String DRIVER = "Mac"; static final String PRINTER_DRIVER = "Printer"; static final String FILE_DRIVER = "File"; static final String PREVIEW_DRIVER = "Preview"; static final String FAX_DRIVER = "Fax"; /** * Returns an array of <code>PrinterData</code> objects * representing all available printers. * * @return the list of available printers */ public static PrinterData[] getPrinterList() { NSArray printers = NSPrinter.printerNames(); int count = printers.count(); PrinterData[] result = new PrinterData[count]; for (int i = 0; i < count; i++) { NSString str = new NSString(printers.objectAtIndex(i)); char[] buffer = new char[str.length()]; str.getCharacters_(buffer); result[i] = new PrinterData(DRIVER, new String(buffer)); } return result; } /** * Returns a <code>PrinterData</code> object representing * the default printer or <code>null</code> if there is no * printer available on the System. * * @return the default printer data or null * * @since 2.1 */ public static PrinterData getDefaultPrinterData() { //TODO - get default PrinterData[] printers = getPrinterList(); if (printers.length > 0) return printers[0]; return null; } //static int packData(int handle, byte[] buffer, int offset) { // int length = OS.GetHandleSize (handle); // buffer[offset++] = cast(byte)((length & 0xFF) >> 0); // buffer[offset++] = cast(byte)((length & 0xFF00) >> 8); // buffer[offset++] = cast(byte)((length & 0xFF0000) >> 16); // buffer[offset++] = cast(byte)((length & 0xFF000000) >> 24); // int [] ptr = new int [1]; // OS.HLock(handle); // OS.memmove(ptr, handle, 4); // byte[] buffer1 = new byte[length]; // OS.memmove(buffer1, ptr [0], length); // OS.HUnlock(handle); // System.arraycopy(buffer1, 0, buffer, offset, length); // return offset + length; //} //static int unpackData(int[] handle, byte[] buffer, int offset) { // int length = // ((buffer[offset++] & 0xFF) << 0) | // ((buffer[offset++] & 0xFF) << 8) | // ((buffer[offset++] & 0xFF) << 16) | // ((buffer[offset++] & 0xFF) << 24); // handle[0] = OS.NewHandle(length); // if (handle[0] is 0) DWT.error(DWT.ERROR_NO_HANDLES); // int[] ptr = new int[1]; // OS.HLock(handle[0]); // OS.memmove(ptr, handle[0], 4); // byte[] buffer1 = new byte[length]; // System.arraycopy(buffer, offset, buffer1, 0, length); // OS.memmove(ptr[0], buffer1, length); // OS.HUnlock(handle[0]); // return offset + length; //} /** * Constructs a new printer representing the default printer. * <p> * You must dispose the printer when it is no longer required. * </p> * * @exception DWTError <ul> * <li>ERROR_NO_HANDLES - if there are no valid printers * </ul> * * @see Device#dispose */ public this() { this(null); } /** * Constructs a new printer given a <code>PrinterData</code> * object representing the desired printer. * <p> * You must dispose the printer when it is no longer required. * </p> * * @param data the printer data for the specified printer * * @exception IllegalArgumentException <ul> * <li>ERROR_INVALID_ARGUMENT - if the specified printer data does not represent a valid printer * </ul> * @exception DWTError <ul> * <li>ERROR_NO_HANDLES - if there are no valid printers * </ul> * * @see Device#dispose */ public this(PrinterData data) { super (checkNull(data)); } /** * Given a desired <em>client area</em> for the receiver * (as described by the arguments), returns the bounding * rectangle which would be required to produce that client * area. * <p> * In other words, it returns a rectangle such that, if the * receiver's bounds were set to that rectangle, the area * of the receiver which is capable of displaying data * (that is, not covered by the "trimmings") would be the * rectangle described by the arguments (relative to the * receiver's parent). * </p><p> * Note that there is no setBounds for a printer. This method * is usually used by passing in the client area (the 'printable * area') of the printer. It can also be useful to pass in 0, 0, 0, 0. * </p> * * @param x the desired x coordinate of the client area * @param y the desired y coordinate of the client area * @param width the desired width of the client area * @param height the desired height of the client area * @return the required bounds to produce the given client area * * @exception DWTException <ul> * <li>ERROR_DEVICE_DISPOSED - if the receiver has been disposed</li> * </ul> * * @see #getBounds * @see #getClientArea */ public Rectangle computeTrim(int x, int y, int width, int height) { checkDevice(); // PMRect pageRect = new PMRect(); // PMRect paperRect = new PMRect(); // OS.PMGetAdjustedPageRect(pageFormat, pageRect); // OS.PMGetAdjustedPaperRect(pageFormat, paperRect); // return new Rectangle(x+cast(int)paperRect.left, y+cast(int)paperRect.top, width+cast(int)(paperRect.right-pageRect.right), height+cast(int)(paperRect.bottom-pageRect.bottom)); return null; } /** * Creates the printer handle. * This method is called internally by the instance creation * mechanism of the <code>Device</code> class. * @param deviceData the device data */ protected void create(DeviceData deviceData) { data = cast(PrinterData)deviceData; printer = NSPrinter.static_printerWithName_(NSString.stringWith(data.name)); printer.retain(); // int[] buffer = new int[1]; // if (OS.PMCreateSession(buffer) !is OS.noErr) DWT.error(DWT.ERROR_NO_HANDLES); // printSession = buffer[0]; // if (printSession is 0) DWT.error(DWT.ERROR_NO_HANDLES); // // if (data.otherData !is null) { // /* Deserialize settings */ // int offset = 0; // byte[] otherData = data.otherData; // offset = unpackData(buffer, otherData, offset); // int flatSettings = buffer[0]; // offset = unpackData(buffer, otherData, offset); // int flatFormat = buffer[0]; // if (OS.PMUnflattenPrintSettings(flatSettings, buffer) !is OS.noErr) DWT.error(DWT.ERROR_NO_HANDLES); // printSettings = buffer[0]; // if (printSettings is 0) DWT.error(DWT.ERROR_NO_HANDLES); // if (OS.PMUnflattenPageFormat(flatFormat, buffer) !is OS.noErr) DWT.error(DWT.ERROR_NO_HANDLES); // pageFormat = buffer[0]; // if (pageFormat is 0) DWT.error(DWT.ERROR_NO_HANDLES); // OS.DisposeHandle(flatSettings); // OS.DisposeHandle(flatFormat); // } else { // /* Create default settings */ // if (OS.PMCreatePrintSettings(buffer) !is OS.noErr) DWT.error(DWT.ERROR_NO_HANDLES); // printSettings = buffer[0]; // if (printSettings is 0) DWT.error(DWT.ERROR_NO_HANDLES); // OS.PMSessionDefaultPrintSettings(printSession, printSettings); // if (OS.PMCreatePageFormat(buffer) !is OS.noErr) DWT.error(DWT.ERROR_NO_HANDLES); // pageFormat = buffer[0]; // if (pageFormat is 0) DWT.error(DWT.ERROR_NO_HANDLES); // OS.PMSessionDefaultPageFormat(printSession, pageFormat); // } // // if (PREVIEW_DRIVER.equals(data.driver)) { // OS.PMSessionSetDestination(printSession, printSettings, cast(short) OS.kPMDestinationPreview, 0, 0); // } // String name = data.name; // char[] buffer1 = new char[name.length ()]; // name.getChars(0, buffer1.length, buffer1, 0); // int ptr = OS.CFStringCreateWithCharacters(OS.kCFAllocatorDefault, buffer1, buffer1.length); // if (ptr !is 0) { // OS.PMSessionSetCurrentPrinter(printSession, ptr); // OS.CFRelease(ptr); // } // // OS.PMSessionValidatePrintSettings(printSession, printSettings, null); // OS.PMSessionValidatePageFormat(printSession, pageFormat, null); // // int graphicsContextsArray = OS.CFArrayCreateMutable(OS.kCFAllocatorDefault, 1, 0); // if (graphicsContextsArray !is 0) { // OS.CFArrayAppendValue(graphicsContextsArray, OS.kPMGraphicsContextCoreGraphics()); // OS.PMSessionSetDocumentFormatGeneration(printSession, OS.kPMDocumentFormatPDF(), graphicsContextsArray, 0); // OS.CFRelease(graphicsContextsArray); // } } /** * Destroys the printer handle. * This method is called internally by the dispose * mechanism of the <code>Device</code> class. */ protected void destroy() { if (printer !is null) printer.release(); printer = null; } /** * Invokes platform specific functionality to allocate a new GC handle. * <p> * <b>IMPORTANT:</b> This method is <em>not</em> part of the public * API for <code>Printer</code>. It is marked public only so that it * can be shared within the packages provided by DWT. It is not * available on all platforms, and should never be called from * application code. * </p> * * @param data the platform specific GC data * @return the platform specific GC handle */ public int internal_new_GC(GCData data) { if (isDisposed()) DWT.error(DWT.ERROR_GRAPHIC_DISPOSED); setupNewPage(); // if (data !is null) { // if (isGCCreated) DWT.error(DWT.ERROR_INVALID_ARGUMENT); // data.device = this; // data.background = getSystemColor(DWT.COLOR_WHITE).handle; // data.foreground = getSystemColor(DWT.COLOR_BLACK).handle; // data.font = getSystemFont (); // PMRect paperRect= new PMRect(); // OS.PMGetAdjustedPaperRect(pageFormat, paperRect); // Rect portRect = new Rect(); // portRect.left = cast(short)paperRect.left; // portRect.right = cast(short)paperRect.right; // portRect.top = cast(short)paperRect.top; // portRect.bottom = cast(short)paperRect.bottom; // data.portRect = portRect; // isGCCreated = true; // } // return context; return 0; } protected void init () { super.init(); } /** * Invokes platform specific functionality to dispose a GC handle. * <p> * <b>IMPORTANT:</b> This method is <em>not</em> part of the public * API for <code>Printer</code>. It is marked public only so that it * can be shared within the packages provided by DWT. It is not * available on all platforms, and should never be called from * application code. * </p> * * @param hDC the platform specific GC handle * @param data the platform specific GC data */ public void internal_dispose_GC(int context, GCData data) { if (data !is null) isGCCreated = false; } /** * Releases any internal state prior to destroying this printer. * This method is called internally by the dispose * mechanism of the <code>Device</code> class. */ protected void release () { super.release(); } /** * Starts a print job and returns true if the job started successfully * and false otherwise. * <p> * This must be the first method called to initiate a print job, * followed by any number of startPage/endPage calls, followed by * endJob. Calling startPage, endPage, or endJob before startJob * will result in undefined behavior. * </p> * * @param jobName the name of the print job to start * @return true if the job started successfully and false otherwise. * * @exception DWTException <ul> * <li>ERROR_DEVICE_DISPOSED - if the receiver has been disposed</li> * </ul> * * @see #startPage * @see #endPage * @see #endJob */ public bool startJob(String jobName) { checkDevice(); // if (jobName !is null && jobName.length() !is 0) { // char[] buffer = new char[jobName.length ()]; // jobName.getChars(0, buffer.length, buffer, 0); // int ptr = OS.CFStringCreateWithCharacters(OS.kCFAllocatorDefault, buffer, buffer.length); // if (ptr !is 0) { // OS.PMSetJobNameCFString(printSettings, ptr); // OS.CFRelease (ptr); // } // } // return OS.PMSessionBeginDocumentNoDialog(printSession, printSettings, pageFormat) is OS.noErr; return false; } /** * Ends the current print job. * * @exception DWTException <ul> * <li>ERROR_DEVICE_DISPOSED - if the receiver has been disposed</li> * </ul> * * @see #startJob * @see #startPage * @see #endPage */ public void endJob() { checkDevice(); // if (inPage) { // OS.PMSessionEndPageNoDialog(printSession); // inPage = false; // } // OS.PMSessionEndDocumentNoDialog(printSession); // context = 0; } /** * Cancels a print job in progress. * * @exception DWTException <ul> * <li>ERROR_DEVICE_DISPOSED - if the receiver has been disposed</li> * </ul> */ public void cancelJob() { checkDevice(); // OS.PMSessionSetError(printSession, OS.kPMCancel); // if (inPage) { // OS.PMSessionEndPageNoDialog(printSession); // inPage = false; // } // OS.PMSessionEndDocumentNoDialog(printSession); // context = 0; } static DeviceData checkNull (PrinterData data) { if (data is null) data = new PrinterData(); if (data.driver is null || data.name is null) { PrinterData defaultPrinter = getDefaultPrinterData(); if (defaultPrinter is null) DWT.error(DWT.ERROR_NO_HANDLES); data.driver = defaultPrinter.driver; data.name = defaultPrinter.name; } return data; } /** * Starts a page and returns true if the page started successfully * and false otherwise. * <p> * After calling startJob, this method may be called any number of times * along with a matching endPage. * </p> * * @return true if the page started successfully and false otherwise. * * @exception DWTException <ul> * <li>ERROR_DEVICE_DISPOSED - if the receiver has been disposed</li> * </ul> * * @see #endPage * @see #startJob * @see #endJob */ public bool startPage() { checkDevice(); // if (OS.PMSessionError(printSession) !is OS.noErr) return false; // setupNewPage(); // return context !is 0; return false; } /** * Ends the current page. * * @exception DWTException <ul> * <li>ERROR_DEVICE_DISPOSED - if the receiver has been disposed</li> * </ul> * * @see #startPage * @see #startJob * @see #endJob */ public void endPage() { checkDevice(); // if (inPage) { // OS.PMSessionEndPageNoDialog(printSession); // inPage = false; // } } /** * Returns a point whose x coordinate is the horizontal * dots per inch of the printer, and whose y coordinate * is the vertical dots per inch of the printer. * * @return the horizontal and vertical DPI * * @exception DWTException <ul> * <li>ERROR_DEVICE_DISPOSED - if the receiver has been disposed</li> * </ul> */ public Point getDPI() { checkDevice(); // PMResolution resolution = new PMResolution(); // OS.PMGetResolution(pageFormat, resolution); // return new Point(cast(int)resolution.hRes, cast(int)resolution.vRes); return null; } /** * Returns a rectangle describing the receiver's size and location. * For a printer, this is the size of a physical page, in pixels. * * @return the bounding rectangle * * @exception DWTException <ul> * <li>ERROR_DEVICE_DISPOSED - if the receiver has been disposed</li> * </ul> * * @see #getClientArea * @see #computeTrim */ public Rectangle getBounds() { checkDevice(); // PMRect paperRect = new PMRect(); // OS.PMGetAdjustedPaperRect(pageFormat, paperRect); // return new Rectangle(0, 0, cast(int)(paperRect.right-paperRect.left), cast(int)(paperRect.bottom-paperRect.top)); return null; } /** * Returns a rectangle which describes the area of the * receiver which is capable of displaying data. * For a printer, this is the size of the printable area * of a page, in pixels. * * @return the client area * * @exception DWTException <ul> * <li>ERROR_DEVICE_DISPOSED - if the receiver has been disposed</li> * </ul> * * @see #getBounds * @see #computeTrim */ public Rectangle getClientArea() { checkDevice(); // PMRect pageRect = new PMRect(); // OS.PMGetAdjustedPageRect(pageFormat, pageRect); // return new Rectangle(0, 0, cast(int)(pageRect.right-pageRect.left), cast(int)(pageRect.bottom-pageRect.top)); return null; } /** * Returns a <code>PrinterData</code> object representing the * target printer for this print job. * * @return a PrinterData object describing the receiver */ public PrinterData getPrinterData() { checkDevice(); return data; } /** * On the Mac the core graphics context for printing is only valid between PMSessionBeginPage and PMSessionEndPage, * so printing code has to retrieve and initializes a graphic context for every page like this: * * <pre> * PMSessionBeginDocument * PMSessionBeginPage * PMSessionGetGraphicsContext * // ... use context * PMSessionEndPage * PMSessionEndDocument * </pre> * * In DWT it is OK to create a GC once between startJob / endJob and use it for all pages in between: * * <pre> * startJob(...); * GC gc= new GC(printer); * startPage(); * // ... use gc * endPage(); * gc.dispose(); * endJob(); * </pre> * * The solution to resolve this difference is to rely on the fact that Mac OS X returns the same but * reinitialized graphics context for every page. So we only have to account for the fact that DWT assumes * that the graphics context keeps it settings across a page break when it actually does not. * So we have to copy some settings that exist in the CGC before a PMSessionEndPage to the CGC after a PMSessionBeginPage. * <p> * In addition to this we have to cope with the situation that in DWT we can create a GC before a call to * PMSessionBeginPage. For this we decouple the call to PMSessionBeginPage from * DWT's method startPage as follows: if a new GC is created before a call to startPage, internal_new_GC * does the PMSessionBeginPage and the next following startPage does nothing. * </p> */ void setupNewPage() { // if (!inPage) { // inPage= true; // OS.PMSessionBeginPageNoDialog(printSession, pageFormat, null); // int[] buffer = new int[1]; // OS.PMSessionGetGraphicsContext(printSession, 0, buffer); // if (context is 0) { // context = buffer[0]; // } else { // if (context !is buffer[0]) DWT.error(DWT.ERROR_UNSPECIFIED); // } // PMRect paperRect= new PMRect(); // OS.PMGetAdjustedPaperRect(pageFormat, paperRect); // OS.CGContextScaleCTM(context, 1, -1); // OS.CGContextTranslateCTM(context, 0, -cast(float)(paperRect.bottom-paperRect.top)); // OS.CGContextSetStrokeColorSpace(context, colorspace); // OS.CGContextSetFillColorSpace(context, colorspace); // } } }