office-gobmx/xmloff/source/style/TransGradientStyle.cxx
Regina Henschel 567dbcf687 tdf#161327 Interpret angle units in dr3d:end-angle ..
.. and draw:rotation in <draw:hatch> element.

ODF 1.1 has not specified the syntax of datatype 'angle'. Since ODF 1.2
it is specified as double with unit "deg", "grad" or "rad", or without
unit. The unit-less value is specified to be in degrees. But OOo, AOO
and all LO versions had written the value unit-less in 1/10th of a
degree in some cases.

To fix it, LibreOffic will be enabled to read units. When then the
active versions are able to read units, starting with the then actual
version, LibreOffice will write angles with unit 'deg'.

This has already be done for gradients, see tdf#89475. This patch
starts the first step to make LibreOffice able to read units for
dr3d:end-angle (UNO D3DEndAngle) and for draw:rotation (UNO
FillHatch.Angle). I have not found further cases of writing 1/10deg.

The patch still writes unit-less 1/10th of a degree for export to
ODF 1.3 and earlier. When it is time to write unit degree or when
LibreOffice supports the next ODF versions, some places need to be
adapted. They are marked.

The converter convertAngle is renamed to convert10thDegAngle() to
indicate, that it is special. The parts, which were specific to
gradients are moved to the gradients, so that it is now usable for
dr3d:angle and draw:rotation too.

I intend to write next a patch that enables LibreOffice to read angle
units for cases where LibreOffice already writes unit-less values in
degree. That is not so urgent, but to bring LibreOffice nearer to ODF,
reading angle units should be implemented nevertheless.

The file xmlbahdl.hxx is moved from xmloff/source/style to xmloff/inc
to have access to it from xmloff/source/draw.

Change-Id: I8ffc2735f8bcfefb86efa80eb05f900c32403f31
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/168336
Tested-by: Jenkins
Reviewed-by: Michael Stahl <michael.stahl@allotropia.de>
Reviewed-by: Regina Henschel <rb.henschel@t-online.de>
2024-06-11 10:29:17 +02:00

299 lines
11 KiB
C++

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*
* This file incorporates work covered by the following license notice:
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed
* with this work for additional information regarding copyright
* ownership. The ASF licenses this file to you under the Apache
* License, Version 2.0 (the "License"); you may not use this file
* except in compliance with the License. You may obtain a copy of
* the License at http://www.apache.org/licenses/LICENSE-2.0 .
*/
#include <TransGradientStyle.hxx>
#include <com/sun/star/awt/Gradient2.hpp>
#include <basegfx/utils/bgradient.hxx>
#include <comphelper/documentconstants.hxx>
#include <rtl/ustrbuf.hxx>
#include <rtl/ustring.hxx>
#include <sal/log.hxx>
#include <sax/tools/converter.hxx>
#include <tools/color.hxx>
#include <xmloff/xmlement.hxx>
#include <xmloff/xmlexp.hxx>
#include <xmloff/xmlimp.hxx>
#include <xmloff/xmlnamespace.hxx>
#include <xmloff/xmluconv.hxx>
#include <docmodel/uno/UnoGradientTools.hxx>
using namespace ::com::sun::star;
using namespace ::xmloff::token;
SvXMLEnumMapEntry<awt::GradientStyle> const pXML_GradientStyle_Enum[] =
{
{ XML_LINEAR, awt::GradientStyle_LINEAR },
{ XML_GRADIENTSTYLE_AXIAL, awt::GradientStyle_AXIAL },
{ XML_GRADIENTSTYLE_RADIAL, awt::GradientStyle_RADIAL },
{ XML_GRADIENTSTYLE_ELLIPSOID, awt::GradientStyle_ELLIPTICAL },
{ XML_GRADIENTSTYLE_SQUARE, awt::GradientStyle_SQUARE },
{ XML_GRADIENTSTYLE_RECTANGULAR, awt::GradientStyle_RECT },
{ XML_TOKEN_INVALID, awt::GradientStyle(0) }
};
// Import
XMLTransGradientStyleImport::XMLTransGradientStyleImport( SvXMLImport& rImp )
: rImport(rImp)
{
}
void XMLTransGradientStyleImport::importXML(
const uno::Reference< xml::sax::XFastAttributeList >& xAttrList,
uno::Any& rValue,
OUString& rStrName )
{
OUString aDisplayName;
awt::Gradient2 aGradient;
aGradient.XOffset = 0;
aGradient.YOffset = 0;
aGradient.StartIntensity = 100;
aGradient.EndIntensity = 100;
aGradient.Angle = 0;
aGradient.Border = 0;
for (auto &aIter : sax_fastparser::castToFastAttributeList( xAttrList ))
{
sal_Int32 nTmpValue;
switch( aIter.getToken() )
{
case XML_ELEMENT(DRAW, XML_NAME):
{
rStrName = aIter.toString();
}
break;
case XML_ELEMENT(DRAW, XML_DISPLAY_NAME):
{
aDisplayName = aIter.toString();
}
break;
case XML_ELEMENT(DRAW, XML_STYLE):
{
SvXMLUnitConverter::convertEnum( aGradient.Style, aIter.toView(), pXML_GradientStyle_Enum );
}
break;
case XML_ELEMENT(DRAW, XML_CX):
::sax::Converter::convertPercent( nTmpValue, aIter.toView() );
aGradient.XOffset = sal::static_int_cast< sal_Int16 >(nTmpValue);
break;
case XML_ELEMENT(DRAW, XML_CY):
::sax::Converter::convertPercent( nTmpValue, aIter.toView() );
aGradient.YOffset = sal::static_int_cast< sal_Int16 >(nTmpValue);
break;
case XML_ELEMENT(DRAW, XML_START):
{
sal_Int32 aStartTransparency;
::sax::Converter::convertPercent( aStartTransparency, aIter.toView() );
sal_uInt8 n = sal::static_int_cast< sal_uInt8 >(
( (100 - aStartTransparency) * 255 ) / 100 );
Color aColor( n, n, n );
aGradient.StartColor = static_cast<sal_Int32>( aColor );
}
break;
case XML_ELEMENT(DRAW, XML_END):
{
sal_Int32 aEndTransparency;
::sax::Converter::convertPercent( aEndTransparency, aIter.toView() );
sal_uInt8 n = sal::static_int_cast< sal_uInt8 >(
( (100 - aEndTransparency) * 255 ) / 100 );
Color aColor( n, n, n );
aGradient.EndColor = static_cast<sal_Int32>( aColor );
}
break;
case XML_ELEMENT(DRAW, XML_GRADIENT_ANGLE):
{
auto const cmp12(rImport.GetODFVersion().compareTo(ODFVER_012_TEXT));
// tdf#89475 try to detect borked OOo angles
bool const bIsWrongOOo10thDegAngle(
(cmp12 < 0)
|| (cmp12 == 0
&& (rImport.isGeneratorVersionOlderThan(SvXMLImport::AOO_4x,
SvXMLImport::LO_7x)
// also for AOO 4.x, assume there won't ever be a 4.2
|| rImport.getGeneratorVersion() == SvXMLImport::AOO_4x)));
sal_Int16 nAngle;
bool const bSuccess = ::sax::Converter::convert10thDegAngle(
nAngle, aIter.toView(), bIsWrongOOo10thDegAngle);
if (bSuccess)
{ // limit to valid range [0..3600[
nAngle = nAngle % 3600;
if (nAngle < 0)
nAngle += 3600;
aGradient.Angle = nAngle;
}
SAL_INFO_IF(!bSuccess, "xmloff.style", "failed to import draw:angle");
}
break;
case XML_ELEMENT(DRAW, XML_BORDER):
::sax::Converter::convertPercent( nTmpValue, aIter.toView() );
aGradient.Border = sal::static_int_cast< sal_Int16 >(nTmpValue);
break;
default:
XMLOFF_WARN_UNKNOWN("xmloff.style", aIter);
}
}
rValue <<= aGradient;
if( !aDisplayName.isEmpty() )
{
rImport.AddStyleDisplayName( XmlStyleFamily::SD_GRADIENT_ID, rStrName,
aDisplayName );
rStrName = aDisplayName;
}
}
// Export
XMLTransGradientStyleExport::XMLTransGradientStyleExport( SvXMLExport& rExp )
: rExport(rExp)
{
}
void XMLTransGradientStyleExport::exportXML(
const OUString& rStrName,
const uno::Any& rValue )
{
// MCGR: We try to write the gradient so, that applications without multi-color gradient support
// can render it as best as possible.
// This is similar to XMLGradientStyleExport::exportXML(). For details see there.
if( rStrName.isEmpty() )
return;
if (!rValue.has<css::awt::Gradient2>() && !rValue.has<css::awt::Gradient>())
return;
basegfx::BGradient aGradient = model::gradient::getFromAny(rValue);
aGradient.tryToConvertToAxial();
aGradient.tryToRecreateBorder(nullptr);
OUString aStrValue;
OUStringBuffer aOut;
// Style
if (!SvXMLUnitConverter::convertEnum(aOut, aGradient.GetGradientStyle(),
pXML_GradientStyle_Enum))
return;
// Name
bool bEncoded = false;
rExport.AddAttribute( XML_NAMESPACE_DRAW, XML_NAME,
rExport.EncodeStyleName( rStrName,
&bEncoded ) );
if( bEncoded )
rExport.AddAttribute( XML_NAMESPACE_DRAW, XML_DISPLAY_NAME,
rStrName );
aStrValue = aOut.makeStringAndClear();
rExport.AddAttribute( XML_NAMESPACE_DRAW, XML_STYLE, aStrValue );
// Center x/y
if (awt::GradientStyle_LINEAR != aGradient.GetGradientStyle()
&& awt::GradientStyle_AXIAL != aGradient.GetGradientStyle())
{
::sax::Converter::convertPercent(aOut, aGradient.GetXOffset());
aStrValue = aOut.makeStringAndClear();
rExport.AddAttribute( XML_NAMESPACE_DRAW, XML_CX, aStrValue );
::sax::Converter::convertPercent(aOut, aGradient.GetYOffset());
aStrValue = aOut.makeStringAndClear();
rExport.AddAttribute( XML_NAMESPACE_DRAW, XML_CY, aStrValue );
}
// LO uses a gray color as transparency. ODF uses opacity in range [0%,100%].
// Default 100% opacity.
double fOpacityStartPerc = 100.0;
double fOpacityEndPerc = 100.0;
if (!aGradient.GetColorStops().empty())
{
fOpacityStartPerc
= (1.0 - aGradient.GetColorStops().front().getStopColor().getRed()) * 100.0;
fOpacityEndPerc = (1.0 - aGradient.GetColorStops().back().getStopColor().getRed()) * 100.0;
}
// Opacity start
::sax::Converter::convertPercent(aOut, static_cast<sal_Int32>(std::lround(fOpacityStartPerc)));
aStrValue = aOut.makeStringAndClear();
rExport.AddAttribute( XML_NAMESPACE_DRAW, XML_START, aStrValue );
// Opacity end
::sax::Converter::convertPercent( aOut, static_cast<sal_Int32>(std::lround(fOpacityEndPerc)));
aStrValue = aOut.makeStringAndClear();
rExport.AddAttribute( XML_NAMESPACE_DRAW, XML_END, aStrValue );
// Angle
if (awt::GradientStyle_RADIAL != aGradient.GetGradientStyle())
{
// true: wrong, but backward compatible with OOo/LO < 4.4
// false: OFFICE-3774 tdf#89475 write valid ODF 1.2 angle; needs LO 4.4 to import
bool bIsWrongOOo10thDegAngle(rExport.getSaneDefaultVersion() < SvtSaveOptions::ODFSVER_012
|| rExport.getSaneDefaultVersion()
== SvtSaveOptions::ODFSVER_012_EXT_COMPAT);
::sax::Converter::convert10thDegAngle(aOut, aGradient.GetAngle().get(),
bIsWrongOOo10thDegAngle);
aStrValue = aOut.makeStringAndClear();
rExport.AddAttribute(XML_NAMESPACE_DRAW, XML_GRADIENT_ANGLE, aStrValue);
}
// Border
::sax::Converter::convertPercent(aOut, aGradient.GetBorder());
aStrValue = aOut.makeStringAndClear();
rExport.AddAttribute( XML_NAMESPACE_DRAW, XML_BORDER, aStrValue );
// ctor writes start tag. End-tag is written by destructor at block end.
SvXMLElementExport rElem(rExport, XML_NAMESPACE_DRAW, XML_OPACITY, true, false);
// Write child elements <loext:opacity-stop>
// Do not export in standard ODF 1.3 or older.
if ((rExport.getSaneDefaultVersion() & SvtSaveOptions::ODFSVER_EXTENDED) == 0)
return;
if (aGradient.GetColorStops().empty())
return;
double fPreviousOffset = 0.0;
for (auto& aCandidate : aGradient.GetColorStops())
{
// Attribute svg:offset. Make sure offsets are increasing.
double fOffset = std::clamp<double>(aCandidate.getStopOffset(), 0.0, 1.0);
if (fOffset < fPreviousOffset)
fOffset = fPreviousOffset;
rExport.AddAttribute(XML_NAMESPACE_SVG, XML_OFFSET, OUString::number(fOffset));
fPreviousOffset = fOffset;
// Attribute svg:stop-opacity, data type zeroToOneDecimal
double fOpacity = std::clamp<double>(1.0 - aCandidate.getStopColor().getRed(), 0.0, 1.0);
rExport.AddAttribute(XML_NAMESPACE_SVG, XML_STOP_OPACITY, OUString::number(fOpacity));
// write opacity stop element
SvXMLElementExport aStopElement(rExport, XML_NAMESPACE_LO_EXT, XML_OPACITY_STOP, true, true);
}
}
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */