merge the formfield patch from ooo-build
[ooovba.git] / helpcontent2 / source / text / schart / 01 / three_d_view.xhp
blob83175cd14a750dea8e6272fca0d4ae68292c93a1
1 <?xml version="1.0" encoding="UTF-8"?>
2 <helpdocument version="1.0">
4 <!--
5 ***********************************************************************
7 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
8 *
9 * Copyright 2008 by Sun Microsystems, Inc.
11 * OpenOffice.org - a multi-platform office productivity suite
13 * $RCSfile: soffice2xmlhelp.xsl,v $
14 * $Revision: 1.8 $
16 * This file is part of OpenOffice.org.
18 * OpenOffice.org is free software: you can redistribute it and/or modify
19 * it under the terms of the GNU Lesser General Public License version 3
20 * only, as published by the Free Software Foundation.
22 * OpenOffice.org is distributed in the hope that it will be useful,
23 * but WITHOUT ANY WARRANTY; without even the implied warranty of
24 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
25 * GNU Lesser General Public License version 3 for more details
26 * (a copy is included in the LICENSE file that accompanied this code).
28 * You should have received a copy of the GNU Lesser General Public License
29 * version 3 along with OpenOffice.org. If not, see
30 * <http://www.openoffice.org/license.html>
31 * for a copy of the LGPLv3 License.
33 ************************************************************************
34 -->
37 <meta>
38 <topic id="textschart01three_d_viewxhp" indexer="include" status="PUBLISH">
39 <title xml-lang="en-US" id="tit">3D View </title>
40 <filename>/text/schart/01/three_d_view.xhp</filename>
41 </topic>
42 </meta>
43 <body>
44 <bookmark xml-lang="en-US" branch="index" id="bm_id3156423"><bookmark_value>3D charts</bookmark_value>
45 <bookmark_value>charts; 3D views</bookmark_value>
46 <bookmark_value>illumination; 3D charts</bookmark_value>
47 </bookmark>
48 <bookmark xml-lang="en-US" branch="hid/.uno:View3D" id="bm_id3150449" localize="false"/><comment>mw made "3D charts;" a one level entry</comment>
49 <paragraph xml-lang="en-US" id="hd_id3464461" role="heading" level="1" l10n="NEW"><variable id="three_d_view"><link href="text/schart/01/three_d_view.xhp">3D View</link>
50 </variable></paragraph>
51 <paragraph xml-lang="en-US" id="par_id6998809" role="paragraph" l10n="CHG">On the first page of the <link href="text/schart/01/wiz_chart_type.xhp">Chart Wizard</link> or in the context menu of a chart you can choose a chart type. <ahelp hid="." visibility="hidden">Opens a dialog to edit the properties of a three dimensional view for Column, Bar, Pie, and Area charts. For Line and XY (Scatter) charts you can see 3D lines.</ahelp><comment>must be AHID, see i80656</comment></paragraph>
52 <section id="howtoget">
53 <embed href="text/schart/00/00000004.xhp#wiz"/>
54 </section>
55 <embed href="text/shared/00/00000001.xhp#ShiftF1"/>
56 <paragraph xml-lang="en-US" id="par_id6942045" role="paragraph" l10n="NEW">The chart preview responds to the new settings that you enter in the dialog. </paragraph>
57 <list type="ordered">
58 <listitem>
59 <paragraph xml-lang="en-US" id="par_id3806878" role="paragraph" l10n="NEW">When you leave the dialog with OK, the settings are applied permanently. </paragraph>
60 </listitem>
61 <listitem>
62 <paragraph xml-lang="en-US" id="par_id130619" role="paragraph" l10n="NEW">When you leave the dialog with Cancel or Escape, the chart returns to the state when you opened the dialog.</paragraph>
63 </listitem>
64 </list>
65 <paragraph xml-lang="en-US" id="par_id8081911" role="paragraph" l10n="NEW">For a 3D chart you can choose <item type="menuitem">Format - 3D View</item> to set perspective, appearance and illumination.</paragraph>
66 <paragraph xml-lang="en-US" id="hd_id2924283" role="heading" level="2" l10n="NEW">Perspective</paragraph>
67 <list type="ordered">
68 <listitem>
69 <paragraph xml-lang="en-US" id="par_id5781731" role="paragraph" l10n="NEW">Enter the values for rotation of the chart on the three axes and for a perspective view.</paragraph>
70 </listitem>
71 </list>
72 <paragraph xml-lang="en-US" id="par_id9999694" role="paragraph" l10n="NEW">Set all angles to 0 for a front view of the chart. Pie charts and donut charts are shown as circles.</paragraph>
73 <paragraph xml-lang="en-US" id="par_id2861720" role="paragraph" l10n="NEW">With Right-angled axes enabled, you can rotate the chart contents only in X and Y direction, that is, parallel to the chart borders.</paragraph>
74 <paragraph xml-lang="en-US" id="par_id2216559" role="paragraph" l10n="NEW">An x value of 90, with y and z set to 0, provides a view from top down to the chart. With x set to -90, you see the bottom of the chart.</paragraph>
75 <paragraph xml-lang="en-US" id="par_id7869502" role="paragraph" l10n="NEW">The rotations are applied in the order first x, then y, last z.</paragraph>
76 <paragraph xml-lang="en-US" id="par_id9852900" role="paragraph" l10n="NEW">When shading is enabled and you rotate a chart, the lights are rotated as if they are fixed to the chart.</paragraph>
77 <paragraph xml-lang="en-US" id="par_id2578203" role="note" l10n="NEW">The rotation axes always relate to the page, not to the chart's axes. This is different from some other chart programs.</paragraph>
78 <paragraph xml-lang="en-US" id="par_id4923245" role="paragraph" l10n="NEW">Select the Perspective check box to view the chart in central perspective as through a camera lens instead of using a parallel projection. </paragraph>
79 <paragraph xml-lang="en-US" id="par_id3416547" role="paragraph" l10n="NEW">Set the focus length with the spin button. 100% gives a perspective view where a far edge in the chart looks approximately half as big as a near edge.</paragraph>
80 <paragraph xml-lang="en-US" id="par_id3791924" role="note" l10n="NEW">Older versions of %PRODUCTNAME cannot display the percentage of perspective the same way as the current version.</paragraph><comment>Right-angled axes</comment>
81 <bookmark xml-lang="en-US" branch="hid/chart2_CheckBox_TP_3D_SCENEGEOMETRY_CBX_RIGHT_ANGLED_AXES" id="bm_id5293740" localize="false"/>
82 <paragraph xml-lang="en-US" id="par_id7623828" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">If Right-angled axes is enabled, you can rotate the chart contents only in X and Y direction, that is, parallel to the chart borders. Right-angled axes is enabled by default for newly created 3D charts. Pie and Donut charts do not support right-angled axes.</ahelp></paragraph><comment>X rotation</comment>
83 <bookmark xml-lang="en-US" branch="hid/chart2:MetricField:TP_3D_SCENEGEOMETRY:MTR_FLD_X_ROTATION" id="bm_id6549272" localize="false"/>
84 <paragraph xml-lang="en-US" id="par_id4721823" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Sets the rotation of the chart on the x axis. The preview responds to the new settings.</ahelp></paragraph><comment>Y rotation </comment>
85 <bookmark xml-lang="en-US" branch="hid/chart2:MetricField:TP_3D_SCENEGEOMETRY:MTR_FLD_Y_ROTATION" id="bm_id6529740" localize="false"/>
86 <paragraph xml-lang="en-US" id="par_id5806756" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Sets the rotation of the chart on the y axis. The preview responds to the new settings.</ahelp></paragraph><comment>z rotation</comment>
87 <bookmark xml-lang="en-US" branch="hid/chart2:MetricField:TP_3D_SCENEGEOMETRY:MTR_FLD_Z_ROTATION" id="bm_id9121982" localize="false"/>
88 <paragraph xml-lang="en-US" id="par_id8915372" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Sets the rotation of the chart on the z axis. The preview responds to the new settings.</ahelp></paragraph><comment>perspective</comment>
89 <bookmark xml-lang="en-US" branch="hid/chart2:CheckBox:TP_3D_SCENEGEOMETRY:CBX_PERSPECTIVE" id="bm_id2394482" localize="false"/>
90 <bookmark xml-lang="en-US" branch="hid/chart2:MetricField:TP_3D_SCENEGEOMETRY:MTR_FLD_PERSPECTIVE" id="bm_id3808404" localize="false"/>
91 <paragraph xml-lang="en-US" id="par_id6070436" role="paragraph" l10n="CHG"><ahelp hid="." visibility="hidden">Mark the Perspective box to view the chart as through a camera lens. Use the spin button to set the percentage. With a high percentage nearer objects look bigger than more distant objects.</ahelp></paragraph>
92 <paragraph xml-lang="en-US" id="hd_id7564012" role="heading" level="2" l10n="NEW">Appearance</paragraph>
93 <list type="ordered">
94 <listitem>
95 <paragraph xml-lang="en-US" id="par_id1186254" role="paragraph" l10n="NEW">Select a scheme from the list box.</paragraph>
96 </listitem>
97 </list>
98 <paragraph xml-lang="en-US" id="par_id7432477" role="paragraph" l10n="NEW">By selecting a scheme, the check boxes and the light sources are set accordingly.</paragraph>
99 <list type="ordered">
100 <listitem>
101 <paragraph xml-lang="en-US" id="par_id7141026" role="paragraph" l10n="NEW">If you mark or unmark a combination of check boxes that is not given by the Realistic or Simple scheme, you create a Custom scheme.</paragraph>
102 </listitem>
103 <listitem>
104 <paragraph xml-lang="en-US" id="par_id1579027" role="paragraph" l10n="NEW">Mark <emph>Shading</emph> to use the Gouraud method for rendering the surface, otherwise a flat method is used. </paragraph>
105 <paragraph xml-lang="en-US" id="par_id5624561" role="paragraph" l10n="NEW">The flat method sets a single color and brightness for each polygon. The edges are visible, soft gradients and spot lights are not possible. </paragraph>
106 <paragraph xml-lang="en-US" id="par_id5901058" role="paragraph" l10n="NEW">The Gouraud method applies gradients for a smoother, more realistic look.<comment>Regina: Need an external article on web, which describes the 3D engine in detail. Till that, the user should get some information on Gouraud and Flat.</comment></paragraph>
107 </listitem>
108 </list>
109 <list type="ordered">
110 <listitem>
111 <paragraph xml-lang="en-US" id="par_id8469191" role="paragraph" l10n="NEW">Mark <emph>Object Borders</emph> to draw lines along the edges.</paragraph>
112 </listitem>
113 <listitem>
114 <paragraph xml-lang="en-US" id="par_id4407483" role="paragraph" l10n="NEW">Mark <emph>Rounded Edges</emph> to smooth the edges of box shapes.</paragraph>
115 </listitem>
116 </list><comment>Scheme</comment>
117 <bookmark xml-lang="en-US" branch="hid/chart2:ListBox:TP_3D_SCENEAPPEARANCE:LB_SCHEME" id="bm_id631733" localize="false"/>
118 <paragraph xml-lang="en-US" id="par_id8531449" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Select a scheme from the list box, or click any of the check boxes below.</ahelp></paragraph><comment>Shading</comment>
119 <bookmark xml-lang="en-US" branch="hid/chart2:CheckBox:TP_3D_SCENEAPPEARANCE:CB_SHADING" id="bm_id7811822" localize="false"/>
120 <paragraph xml-lang="en-US" id="par_id9183935" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Applies Gouraud shading if marked, or flat shading if unmarked.</ahelp></paragraph><comment>Object borders</comment>
121 <bookmark xml-lang="en-US" branch="hid/chart2:CheckBox:TP_3D_SCENEAPPEARANCE:CB_OBJECTLINES" id="bm_id3640247" localize="false"/>
122 <paragraph xml-lang="en-US" id="par_id946684" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Shows borders around the areas by setting the line style to Solid.</ahelp></paragraph><comment>Rounded Edges</comment>
123 <bookmark xml-lang="en-US" branch="hid/chart2:Checkbox:TP_3D_SCENEAPPEARANCE:CB_ROUNDEDEDGE" id="bm_id4585100" localize="false"/>
124 <paragraph xml-lang="en-US" id="par_id9607226" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Edges are rounded by 5%.</ahelp></paragraph>
125 <paragraph xml-lang="en-US" id="hd_id1939451" role="heading" level="2" l10n="NEW">Illumination</paragraph>
126 <paragraph xml-lang="en-US" id="par_id9038972" role="paragraph" l10n="NEW">Set the light sources for the 3D view.</paragraph>
127 <list type="ordered">
128 <listitem>
129 <paragraph xml-lang="en-US" id="par_id6531266" role="paragraph" l10n="NEW">Click any of the eight buttons to switch a directed light source on or off.</paragraph>
130 <paragraph xml-lang="en-US" id="par_id6173894" role="paragraph" l10n="NEW">By default, the second light source is switched on. It is the first of seven "normal", uniform light sources. The light source number one projects a specular light with highlights.</paragraph>
131 </listitem>
132 <listitem>
133 <paragraph xml-lang="en-US" id="par_id2761314" role="paragraph" l10n="CHG">For the selected light source, you can then choose a color and intensity in the list box just below the eight buttons. The brightness values of all lights are added, so use dark colors when you enable multiple lights.</paragraph>
134 </listitem>
135 <listitem>
136 <paragraph xml-lang="en-US" id="par_id3912778" role="paragraph" l10n="NEW">The small preview inside this tab page has two sliders to set the vertical and horizontal position of the selected light source. The light source always aims to the middle of the object.</paragraph>
137 </listitem>
138 <listitem>
139 <paragraph xml-lang="en-US" id="par_id3163853" role="paragraph" l10n="NEW">The button in the corner of the small preview switches the internal illumination model between a sphere and a cube.<comment>Regina: Are you sure? I thought, that it only toggles the preview in the dialog.</comment></paragraph>
140 </listitem>
141 <listitem>
142 <paragraph xml-lang="en-US" id="par_id121158" role="paragraph" l10n="NEW">Use the Ambient light list box to define the ambient light which shines with a uniform intensity from all directions.</paragraph>
143 </listitem>
144 </list><comment>preview right bar</comment>
145 <bookmark xml-lang="en-US" branch="hid/34145" id="bm_id8956572" localize="false"/>
146 <paragraph xml-lang="en-US" id="par_id2423780" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Drag the right slider to set the vertical height and direction of the selected light source.</ahelp></paragraph><comment>preview bottom bar</comment>
147 <bookmark xml-lang="en-US" branch="hid/34144" id="bm_id500808" localize="false"/>
148 <paragraph xml-lang="en-US" id="par_id2569658" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Drag the bottom slider to set the horizontal position and direction of the selected light source.</ahelp></paragraph><comment>preview right bottom button</comment>
149 <bookmark xml-lang="en-US" branch="hid/34146" id="bm_id8366649" localize="false"/>
150 <paragraph xml-lang="en-US" id="par_id6394238" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Click to switch between an illumination model of a sphere or a cube.</ahelp></paragraph><comment>Light source</comment>
151 <bookmark xml-lang="en-US" branch="hid/chart2:ImageButton:TP_3D_SCENEILLUMINATION:BTN_LIGHT_1" id="bm_id2334665" localize="false"/>
152 <paragraph xml-lang="en-US" id="par_id533768" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Click to enable or disable the specular light source with highlights.</ahelp></paragraph>
153 <bookmark xml-lang="en-US" branch="hid/chart2:ImageButton:TP_3D_SCENEILLUMINATION:BTN_LIGHT_2" id="bm_id476393" localize="false"/>
154 <bookmark xml-lang="en-US" branch="hid/chart2:ImageButton:TP_3D_SCENEILLUMINATION:BTN_LIGHT_3" id="bm_id2655720" localize="false"/>
155 <bookmark xml-lang="en-US" branch="hid/chart2:ImageButton:TP_3D_SCENEILLUMINATION:BTN_LIGHT_4" id="bm_id3682058" localize="false"/>
156 <bookmark xml-lang="en-US" branch="hid/chart2:ImageButton:TP_3D_SCENEILLUMINATION:BTN_LIGHT_5" id="bm_id5977965" localize="false"/>
157 <bookmark xml-lang="en-US" branch="hid/chart2:ImageButton:TP_3D_SCENEILLUMINATION:BTN_LIGHT_6" id="bm_id3050325" localize="false"/>
158 <bookmark xml-lang="en-US" branch="hid/chart2:ImageButton:TP_3D_SCENEILLUMINATION:BTN_LIGHT_7" id="bm_id9421979" localize="false"/>
159 <bookmark xml-lang="en-US" branch="hid/chart2:ImageButton:TP_3D_SCENEILLUMINATION:BTN_LIGHT_8" id="bm_id1646778" localize="false"/>
160 <paragraph xml-lang="en-US" id="par_id7214270" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Click to enable or disable the uniform light source.</ahelp></paragraph>
161 <bookmark xml-lang="en-US" branch="hid/chart2:ListBox:TP_3D_SCENEILLUMINATION:LB_LIGHTSOURCE" id="bm_id1601611" localize="false"/>
162 <paragraph xml-lang="en-US" id="par_id2186346" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Select a color for the selected light source.</ahelp></paragraph>
163 <bookmark xml-lang="en-US" branch="hid/chart2:ImageButton:TP_3D_SCENEILLUMINATION:BTN_LIGHTSOURCE_COLOR" id="bm_id733359" localize="false"/>
164 <paragraph xml-lang="en-US" id="par_id1331217" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Select a color using the color dialog.</ahelp></paragraph><comment>Ambient light</comment>
165 <bookmark xml-lang="en-US" branch="hid/chart2:ListBox:TP_3D_SCENEILLUMINATION:LB_AMBIENTLIGHT" id="bm_id1228370" localize="false"/>
166 <paragraph xml-lang="en-US" id="par_id393993" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Select a color for the ambient light.</ahelp></paragraph>
167 <bookmark xml-lang="en-US" branch="hid/chart2:ImageButton:TP_3D_SCENEILLUMINATION:BTN_AMBIENT_COLOR" id="bm_id879848" localize="false"/>
168 <paragraph xml-lang="en-US" id="par_id5871761" role="paragraph" l10n="NEW"><ahelp hid="." visibility="hidden">Select a color using the color dialog.</ahelp></paragraph>
169 <section id="relatedtopics">
170 <embed href="text/shared/guide/chart_insert.xhp#chart_insert"/>
171 <embed href="text/schart/01/wiz_chart_type.xhp#wiz_chart_type"/>
172 <embed href="text/schart/01/wiz_data_range.xhp#wiz_data_range"/>
173 <embed href="text/schart/01/wiz_data_series.xhp#wiz_data_series"/>
174 <embed href="text/schart/01/wiz_chart_elements.xhp#wiz_chart_elements"/>
175 </section>
176 </body>
177 </helpdocument>