Thanks, that clears up that a simple added attribute for desired landscape orientation wouldn't be general enough.
So for the example given, is this a correct usage of media-source-properties?
{A4, tray-1, short-edge-first, 3 (portrait)} // How the client should send Portrait document data for A4 in tray-1
And {A4, tray-1, short-edge-first, 5 (reverse-landscape)} // How the client should send Landscape document data for A4 in tray-1
Or am I misunderstanding the intent?
....
Right, as far as the stapling portion of this, if the printer doesn't specify what orientation it wants when the user chooses landscape for PWG-R, then the client would need to infer which direction to rotate in order to give the user the most stapling options (if it always rotated CCW, then the user wouldn't be presented with a "staple top left" option at all for this example). I guess I'm wondering if there are any other gotchas to the client simply choosing a landscape orientation (CCW vs CW) based on finishing options
-----Original Message-----
From: Michael Sweet <msweet at msweet.org>
Sent: Tuesday, June 17, 2025 5:10 AM
To: PWG IPP Workgroup <ipp at pwg.org>
Cc: Michael Ziller <mziller at microsoft.com>
Subject: [EXTERNAL] Re: [IPP] Specifying landscape orientation for PWG-Raster
Michael,
> On Jun 16, 2025, at 12:49 PM, Michael Ziller via ipp <ipp at pwg.org> wrote:
> ...
> Would it make sense to add an attribute such as landscape-orientation-desired (or some better name) where the printer would specify either 4 (landscape) or 5 (reverse-landscape) to carry this PPD information?
So you are conflating raster orientation with finishings orientation.
In the case of raster orientation, that other IPP profile spec I wrote all those years ago for Apple added a "landscape‑orientation‑requested‑preferred (boolean)" attribute for this, however we quickly realized that such a simple solution didn't meet the needs of modern printers. That led to defining "media-source-properties" in the PWG which (for CUPS and PPD files) gets encoded per PageSize/Region by setting the PostScript Orientation key in the page device dictionary. So you might see (for a given printer):
*PageSize Letter: "<</PageSize[612 792]/Orientation 0>>setpagedevice"
and/or:
*PageSize Letter.Transverse: "<</PageSize[792 612]/Orientation 1>>setpagedevice"
Thus, raster data is sent long or short edge as necessary with the correct orientation for a given tray.
....
That said, in the case of finishings orientation the Client is better off to look at the supported finishing corners or edges in order to apply/supply the correct "orientation-requested" value. This is because finishings are always specified WRT a logical portrait sheet, regardless of feed direction/orientation.
For example, if a printer *only* supports 'staple-top-left' (20), a portrait document should use the 'portrait' (3) value for "orientation-requested" but there is no value of "orientation-requested" you can use to get that staple in the top left corner of the landscape page (as you look at it) - it will either be in the bottom left for 'reverse-landscape' (5) or the top right for 'landscape' (4).
To get the "correct" (top left) staple location you'd need to use 'staple-top-right' (20) for the 'reverse-landscape' orientation or 'staple-bottom-left' (21) for the 'landscape' orientation.
________________________
Michael Sweet