1 /* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
3 * This file is part of the LibreOffice project.
5 * This Source Code Form is subject to the terms of the Mozilla Public
6 * License, v. 2.0. If a copy of the MPL was not distributed with this
7 * file, You can obtain one at http://mozilla.org/MPL/2.0/.
9 * This file incorporates work covered by the following license notice:
11 * Licensed to the Apache Software Foundation (ASF) under one or more
12 * contributor license agreements. See the NOTICE file distributed
13 * with this work for additional information regarding copyright
14 * ownership. The ASF licenses this file to you under the Apache
15 * License, Version 2.0 (the "License"); you may not use this file
16 * except in compliance with the License. You may obtain a copy of
17 * the License at http://www.apache.org/licenses/LICENSE-2.0 .
19 #ifndef INCLUDED_VCL_PPDPARSER_HXX
20 #define INCLUDED_VCL_PPDPARSER_HXX
22 #include <sal/config.h>
26 #include <string_view>
27 #include <unordered_map>
30 #include <rtl/string.hxx>
31 #include <rtl/ustring.hxx>
32 #include <tools/solar.h>
33 #include <vcl/dllapi.h>
35 #define PRINTER_PPDDIR "driver"
42 enum PPDValueType
{ eInvocation
, eQuoted
, eSymbol
, eString
, eNo
};
44 struct VCL_DLLPUBLIC PPDValue
47 //CustomOption stuff for fdo#43049
48 //see http://www.cups.org/documentation.php/spec-ppd.html#OPTIONS
49 //for full specs, only the basics are implemented here
51 mutable OUString m_aCustomOption
;
58 * PPDKey - a container for the available options (=values) of a PPD keyword
63 friend class PPDParser
;
64 friend class CPDManager
;
66 typedef std::unordered_map
< OUString
, PPDValue
> hash_type
;
67 typedef std::vector
< PPDValue
* > value_type
;
71 value_type m_aOrderedValues
;
72 const PPDValue
* m_pDefaultValue
;
77 enum class SetupType
{ ExitServer
, Prolog
, DocumentSetup
, PageSetup
, JCLSetup
, AnySetup
};
81 int m_nOrderDependency
;
82 SetupType m_eSetupType
;
84 void eraseValue( const OUString
& rOption
);
86 PPDKey( const OUString
& rKey
);
89 PPDValue
* insertValue(const OUString
& rOption
, PPDValueType eType
, bool bCustomOption
= false);
90 int countValues() const
91 { return m_aValues
.size(); }
92 // neither getValue will return the query option
93 const PPDValue
* getValue( int n
) const;
94 const PPDValue
* getValue( const OUString
& rOption
) const;
95 const PPDValue
* getValueCaseInsensitive( const OUString
& rOption
) const;
96 const PPDValue
* getDefaultValue() const { return m_pDefaultValue
; }
97 const OUString
& getGroup() const { return m_aGroup
; }
99 const OUString
& getKey() const { return m_aKey
; }
100 bool isUIKey() const { return m_bUIOption
; }
101 SetupType
getSetupType() const { return m_eSetupType
; }
102 int getOrderDependency() const { return m_nOrderDependency
; }
105 // define a hash for PPDKey
108 size_t operator()( const PPDKey
* pKey
) const
109 { return reinterpret_cast<size_t>(pKey
); }
114 * PPDParser - parses a PPD file and contains all available keys from it
119 friend class PPDContext
;
120 friend class CUPSManager
;
121 friend class CPDManager
;
122 friend class PPDCache
;
124 typedef std::unordered_map
< OUString
, std::unique_ptr
<PPDKey
> > hash_type
;
125 typedef std::vector
< PPDKey
* > value_type
;
127 void insertKey( std::unique_ptr
<PPDKey
> pKey
);
131 const PPDKey
* m_pKey1
;
132 const PPDValue
* m_pOption1
;
133 const PPDKey
* m_pKey2
;
134 const PPDValue
* m_pOption2
;
136 PPDConstraint() : m_pKey1( nullptr ), m_pOption1( nullptr ), m_pKey2( nullptr ), m_pOption2( nullptr ) {}
140 value_type m_aOrderedKeys
;
141 ::std::vector
< PPDConstraint
> m_aConstraints
;
143 // the full path of the PPD file
145 // some basic attributes
147 bool m_bType42Capable
;
148 sal_uLong m_nLanguageLevel
;
149 rtl_TextEncoding m_aFileEncoding
;
152 // shortcuts to important keys and their default values
154 const PPDKey
* m_pImageableAreas
;
156 const PPDValue
* m_pDefaultPaperDimension
;
157 const PPDKey
* m_pPaperDimensions
;
159 const PPDValue
* m_pDefaultInputSlot
;
161 const PPDValue
* m_pDefaultResolution
;
164 std::unique_ptr
<PPDTranslator
> m_pTranslator
;
166 PPDParser( const OUString
& rFile
);
167 PPDParser(const OUString
& rFile
, const std::vector
<PPDKey
*>& keys
);
169 void parseOrderDependency(const OString
& rLine
);
170 void parseOpenUI(const OString
& rLine
, std::string_view rPPDGroup
);
171 void parseConstraint(const OString
& rLine
);
172 void parse( std::vector
< OString
>& rLines
);
174 OUString
handleTranslation(const OString
& i_rString
, bool i_bIsGlobalized
);
176 static void scanPPDDir( const OUString
& rDir
);
177 static void initPPDFiles(PPDCache
&rPPDCache
);
178 static OUString
getPPDFile( const OUString
& rFile
);
181 static const PPDParser
* getParser( const OUString
& rFile
);
183 const PPDKey
* getKey( int n
) const;
184 const PPDKey
* getKey( const OUString
& rKey
) const;
185 int getKeys() const { return m_aKeys
.size(); }
186 bool hasKey( const PPDKey
* ) const;
188 const ::std::vector
< PPDConstraint
>& getConstraints() const { return m_aConstraints
; }
190 bool isColorDevice() const { return m_bColorDevice
; }
191 bool isType42Capable() const { return m_bType42Capable
; }
192 sal_uLong
getLanguageLevel() const { return m_nLanguageLevel
; }
194 OUString
getDefaultPaperDimension() const;
195 void getDefaultPaperDimension( int& rWidth
, int& rHeight
) const
196 { getPaperDimension( getDefaultPaperDimension(), rWidth
, rHeight
); }
197 bool getPaperDimension( std::u16string_view rPaperName
,
198 int& rWidth
, int& rHeight
) const;
199 // width and height in pt
200 // returns false if paper not found
202 // match the best paper for width and height
203 OUString
matchPaper( int nWidth
, int nHeight
) const;
205 bool getMargins( std::u16string_view rPaperName
,
206 int &rLeft
, int& rRight
,
207 int &rUpper
, int& rLower
) const;
209 // returns true if paper found
213 OUString
getDefaultInputSlot() const;
215 void getDefaultResolution( int& rXRes
, int& rYRes
) const;
217 static void getResolutionFromString( const OUString
&, int&, int& );
220 OUString
translateKey( const OUString
& i_rKey
) const;
221 OUString
translateOption( const OUString
& i_rKey
,
222 const OUString
& i_rOption
) const;
227 * PPDContext - a class to manage user definable states based on the
228 * contents of a PPDParser.
233 typedef std::unordered_map
< const PPDKey
*, const PPDValue
*, PPDKeyhash
> hash_type
;
234 hash_type m_aCurrentValues
;
235 const PPDParser
* m_pParser
;
237 // returns false: check failed, new value is constrained
238 // true: check succeeded, new value can be set
239 bool checkConstraints( const PPDKey
*, const PPDValue
*, bool bDoReset
);
240 bool resetValue( const PPDKey
*, bool bDefaultable
= false );
243 PPDContext( const PPDContext
& rContext
) { operator=( rContext
); }
244 PPDContext
& operator=( const PPDContext
& rContext
) = default;
245 PPDContext
& operator=( PPDContext
&& rContext
);
247 void setParser( const PPDParser
* );
248 const PPDParser
* getParser() const { return m_pParser
; }
250 const PPDValue
* getValue( const PPDKey
* ) const;
251 const PPDValue
* setValue( const PPDKey
*, const PPDValue
*, bool bDontCareForConstraints
= false );
253 std::size_t countValuesModified() const { return m_aCurrentValues
.size(); }
254 const PPDKey
* getModifiedKey( std::size_t n
) const;
256 // public wrapper for the private method
257 bool checkConstraints( const PPDKey
*, const PPDValue
* );
260 char* getStreamableBuffer( sal_uLong
& rBytes
) const;
261 void rebuildFromStreamBuffer(const std::vector
<char> &rBuffer
);
264 int getRenderResolution() const;
266 // width, height in points, paper will contain the name of the selected
267 // paper after the call
268 void getPageSize( OUString
& rPaper
, int& rWidth
, int& rHeight
) const;
273 #endif // INCLUDED_VCL_PPDPARSER_HXX
275 /* vim:set shiftwidth=4 softtabstop=4 expandtab: */