1*cdf0e10cSrcweir/************************************************************************* 2*cdf0e10cSrcweir * 3*cdf0e10cSrcweir * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4*cdf0e10cSrcweir * 5*cdf0e10cSrcweir * Copyright 2000, 2010 Oracle and/or its affiliates. 6*cdf0e10cSrcweir * 7*cdf0e10cSrcweir * OpenOffice.org - a multi-platform office productivity suite 8*cdf0e10cSrcweir * 9*cdf0e10cSrcweir * This file is part of OpenOffice.org. 10*cdf0e10cSrcweir * 11*cdf0e10cSrcweir * OpenOffice.org is free software: you can redistribute it and/or modify 12*cdf0e10cSrcweir * it under the terms of the GNU Lesser General Public License version 3 13*cdf0e10cSrcweir * only, as published by the Free Software Foundation. 14*cdf0e10cSrcweir * 15*cdf0e10cSrcweir * OpenOffice.org is distributed in the hope that it will be useful, 16*cdf0e10cSrcweir * but WITHOUT ANY WARRANTY; without even the implied warranty of 17*cdf0e10cSrcweir * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 18*cdf0e10cSrcweir * GNU Lesser General Public License version 3 for more details 19*cdf0e10cSrcweir * (a copy is included in the LICENSE file that accompanied this code). 20*cdf0e10cSrcweir * 21*cdf0e10cSrcweir * You should have received a copy of the GNU Lesser General Public License 22*cdf0e10cSrcweir * version 3 along with OpenOffice.org. If not, see 23*cdf0e10cSrcweir * <http://www.openoffice.org/license.html> 24*cdf0e10cSrcweir * for a copy of the LGPLv3 License. 25*cdf0e10cSrcweir * 26*cdf0e10cSrcweir ************************************************************************/ 27*cdf0e10cSrcweir 28*cdf0e10cSrcweir#ifndef com_sun_star_graphic_MediaProperties_idl 29*cdf0e10cSrcweir#define com_sun_star_graphic_MediaProperties_idl 30*cdf0e10cSrcweir 31*cdf0e10cSrcweir#include <com/sun/star/beans/PropertyValues.idl> 32*cdf0e10cSrcweir#include <com/sun/star/io/XInputStream.idl> 33*cdf0e10cSrcweir#include <com/sun/star/io/XStream.idl> 34*cdf0e10cSrcweir 35*cdf0e10cSrcweirmodule com { module sun { module star { module graphic 36*cdf0e10cSrcweir{ 37*cdf0e10cSrcweir 38*cdf0e10cSrcweir/** This service describes the properties that are used 39*cdf0e10cSrcweir when using the <type>XGraphicProvider</type> interface methods 40*cdf0e10cSrcweir*/ 41*cdf0e10cSrcweirpublished service MediaProperties 42*cdf0e10cSrcweir{ 43*cdf0e10cSrcweir /** Property that describes the location of the source or target 44*cdf0e10cSrcweir of the graphic as URL. 45*cdf0e10cSrcweir 46*cdf0e10cSrcweir <p>A URL can be used instead of the 47*cdf0e10cSrcweir <member>InputStream</member> or <member>OutputStream</member> 48*cdf0e10cSrcweir property</p> 49*cdf0e10cSrcweir 50*cdf0e10cSrcweir <p>In addition to the normal protocols like file:// or http:// 51*cdf0e10cSrcweir you can use private URL's as follows to get access to graphics 52*cdf0e10cSrcweir lying inside the resource system within an Office context: 53*cdf0e10cSrcweir 54*cdf0e10cSrcweir <ul> 55*cdf0e10cSrcweir <li>private:resource/projectshortname/bitmap/12345</li> 56*cdf0e10cSrcweir <li>private:resource/projectshortname/bitmapex/12345</li> 57*cdf0e10cSrcweir <li>private:resource/projectshortname/image/12345</li> 58*cdf0e10cSrcweir <li>private:resource/projectshortname/imagelist/12345</li> 59*cdf0e10cSrcweir <li>private:resource/projectshortname/imagelist/12345/12</li> 60*cdf0e10cSrcweir </ul> 61*cdf0e10cSrcweirAnd additionally, GraphicObject scheme url's like 62*cdf0e10cSrcweir <ul> <li>vnd.sun.star.GraphicObject:10000000000001940000012FB99807BD</li> </ul> 63*cdf0e10cSrcweir can be used to access graphics held by the GraphicCache implementation. 64*cdf0e10cSrcweir </p> 65*cdf0e10cSrcweir 66*cdf0e10cSrcweir <p>Yet more, you can access graphics in the application-wide image 67*cdf0e10cSrcweir repository by specifying URLs of the form 68*cdf0e10cSrcweir <code>private:graphicrepository/<em><path_in_repository></em></code>. 69*cdf0e10cSrcweir</p> 70*cdf0e10cSrcweir */ 71*cdf0e10cSrcweir [optional, property ] string URL; 72*cdf0e10cSrcweir 73*cdf0e10cSrcweir /** This property is only used for loading graphics or querying 74*cdf0e10cSrcweir graphic descriptors 75*cdf0e10cSrcweir 76*cdf0e10cSrcweir <p>A <member>InputStream</member> can be used instead of the 77*cdf0e10cSrcweir <member>URL</member> property</p> 78*cdf0e10cSrcweir 79*cdf0e10cSrcweir @see com::sun::star::io::XInputStream 80*cdf0e10cSrcweir */ 81*cdf0e10cSrcweir [optional, property ] ::com::sun::star::io::XInputStream InputStream; 82*cdf0e10cSrcweir 83*cdf0e10cSrcweir /** This property is only used for storing graphics 84*cdf0e10cSrcweir 85*cdf0e10cSrcweir <p>A <member>OutputStream</member> can be used instead of the 86*cdf0e10cSrcweir <member>URL</member> property</p> 87*cdf0e10cSrcweir 88*cdf0e10cSrcweir @see com::sun::star::io::XStream 89*cdf0e10cSrcweir */ 90*cdf0e10cSrcweir [optional, property ] ::com::sun::star::io::XStream OutputStream; 91*cdf0e10cSrcweir 92*cdf0e10cSrcweir /** This property is only used for storing graphics and describes the 93*cdf0e10cSrcweir format into which the graphic is to be converted 94*cdf0e10cSrcweir 95*cdf0e10cSrcweir <p>At the moment, the following mime types are supported for storing 96*cdf0e10cSrcweir graphics:</p> 97*cdf0e10cSrcweir 98*cdf0e10cSrcweir <ul> 99*cdf0e10cSrcweir <li>image/bmp</li> 100*cdf0e10cSrcweir <li>image/gif</li> 101*cdf0e10cSrcweir <li>image/jpeg</li> 102*cdf0e10cSrcweir <li>image/png</li> 103*cdf0e10cSrcweir <li>image/tiff</li> 104*cdf0e10cSrcweir <li>image/svg+xml</li> 105*cdf0e10cSrcweir <li>image/x-cmu-raster</li> 106*cdf0e10cSrcweir <li>image/x-emf</li> 107*cdf0e10cSrcweir <li>image/x-eps</li> 108*cdf0e10cSrcweir <li>image/x-met</li> 109*cdf0e10cSrcweir <li>image/x-pict</li> 110*cdf0e10cSrcweir <li>image/x-portable-bitmap</li> 111*cdf0e10cSrcweir <li>image/x-portable-pixmap</li> 112*cdf0e10cSrcweir <li>image/x-wmf</li> 113*cdf0e10cSrcweir <li>image/x-svm</li> 114*cdf0e10cSrcweir <li>image/x-xpixmap</li> 115*cdf0e10cSrcweir <li>image/x-vclgraphic</li> 116*cdf0e10cSrcweir </ul> 117*cdf0e10cSrcweir */ 118*cdf0e10cSrcweir [optional, property ] string MimeType; 119*cdf0e10cSrcweir 120*cdf0e10cSrcweir /** Additional properties that will be passed to the 121*cdf0e10cSrcweir appropriate filter module. 122*cdf0e10cSrcweir */ 123*cdf0e10cSrcweir [optional, property] ::com::sun::star::beans::PropertyValues FilterData; 124*cdf0e10cSrcweir}; 125*cdf0e10cSrcweir 126*cdf0e10cSrcweir} ; } ; } ; } ; 127*cdf0e10cSrcweir 128*cdf0e10cSrcweir#endif 129