Other

AffineTransform

Funkcja AffineTransform używa macierzy 3x3 z domyślnym ostatnim wierszem [0 0 1], aby przekształcić współrzędne źródłowe (x, y) we współrzędne docelowe (x', y') zgodnie z tym wzorem:

 [ x']   [  scaleX  shearX  translateX  ] [ x ]
 [ y'] = [  shearY  scaleY  translateY  ] [ y ]
 [ 1 ]   [      0       0         1     ] [ 1 ]

Po przekształceniu

 x' = scaleX * x + shearX * y + translateX;
 y' = scaleY * y + shearY * x + translateY;

Wiadomość składa się więc z tych 6 elementów macierzy.

Zapis JSON
{
  "scaleX": number,
  "scaleY": number,
  "shearX": number,
  "shearY": number,
  "translateX": number,
  "translateY": number,
  "unit": enum (Unit)
}
Pola
scaleX

number

Element skalowania współrzędnej X.

scaleY

number

Element skalowania współrzędnej Y.

shearX

number

Element ścinający współrzędną X.

shearY

number

Element ścinający współrzędną Y.

translateX

number

Element przesunięcia współrzędnej X.

translateY

number

Element przesunięcia na osi Y.

unit

enum (Unit)

Jednostki elementów do przetłumaczenia.

OpaqueColor

Wartość jednolitego koloru, którą można dostosować do motywu.

Zapis JSON
{

  // Union field kind can be only one of the following:
  "rgbColor": {
    object (RgbColor)
  },
  "themeColor": enum (ThemeColorType)
  // End of list of possible types for union field kind.
}
Pola
Pole zbiorczekind. Rodzaj wartości koloru. kind może mieć tylko jedną z tych wartości:
rgbColor

object (RgbColor)

Nieprzezroczysty kolor RGB.

themeColor

enum (ThemeColorType)

Nieprzezroczysty kolor motywu.

RgbColor

Kolor RGB.

Zapis JSON
{
  "red": number,
  "green": number,
  "blue": number
}
Pola
red

number

Składowa czerwona koloru, od 0,0 do 1,0.

green

number

Składowa zielona koloru, od 0,0 do 1,0.

blue

number

Składowa niebieska koloru, od 0,0 do 1,0.

ThemeColorType

Typy kolorów motywu.

PageProperties zawiera ColorScheme określający mapowanie tych typów kolorów motywu na konkretne kolory.

Wartości w polu enum
THEME_COLOR_TYPE_UNSPECIFIED Nieokreślony kolor motywu. Nie należy używać tej wartości.
DARK1 Reprezentuje pierwszy ciemny kolor.
LIGHT1 Reprezentuje pierwszy jasny kolor.
DARK2 Reprezentuje drugi ciemny kolor.
LIGHT2 Reprezentuje drugi kolor światła.
ACCENT1 Reprezentuje pierwszy kolor akcentu.
ACCENT2 Reprezentuje drugi kolor akcentu.
ACCENT3 Reprezentuje trzeci kolor akcentu.
ACCENT4 Reprezentuje czwarty kolor akcentu.
ACCENT5 Reprezentuje piąty kolor akcentujący.
ACCENT6 Reprezentuje szósty kolor akcentu.
TEXT1 Reprezentuje pierwszy kolor tekstu.
BACKGROUND1 Reprezentuje pierwszy kolor tła.
TEXT2 Reprezentuje drugi kolor tekstu.
BACKGROUND2 Reprezentuje drugi kolor tła.

PropertyState

Możliwe stany usługi.

Wartości w polu enum
RENDERED Jeśli stan właściwości to RENDERED, oznacza to, że element ma odpowiednią właściwość po wyrenderowaniu na stronie. Jeśli element jest kształtem obiektu zastępczego określonym przez pole placeholder i dziedziczy z kształtu obiektu zastępczego, odpowiednie pole może być nieustawione, co oznacza, że wartość właściwości jest dziedziczona z nadrzędnego obiektu zastępczego. Jeśli element nie dziedziczy, pole będzie zawierać renderowaną wartość. Jest to wartość domyślna.
NOT_RENDERED Jeśli stan właściwości to NOT_RENDERED, oznacza to, że element nie ma odpowiedniej właściwości po wyrenderowaniu na stronie. Pole może jednak nadal być ustawione tak, aby mogły je dziedziczyć kształty podrzędne. Aby usunąć właściwość z renderowanego elementu, ustaw jej wartość propertyState na NOT_RENDERED.
INHERIT Jeśli stan właściwości to INHERIT, stan właściwości używa wartości odpowiedniego pola propertyState w kształcie nadrzędnym. Elementy, które nie dziedziczą, nigdy nie będą miały stanu właściwości INHERIT.

SolidFill

wypełnienie jednolitym kolorem, Strona lub element strony jest w całości wypełniony określoną wartością koloru.

Jeśli jakiekolwiek pole nie jest ustawione, jego wartość może zostać odziedziczona z nadrzędnego symbolu zastępczego, jeśli taki istnieje.

Zapis JSON
{
  "color": {
    object (OpaqueColor)
  },
  "alpha": number
}
Pola
color

object (OpaqueColor)

Wartość koloru wypełnienia pełnego.

alpha

number

Ułamek tego color , który ma zostać zastosowany do piksela. Oznacza to, że ostateczny kolor piksela jest określany przez to równanie:

kolor piksela = alfa * (kolor) + (1,0 – alfa) * (kolor tła)

Oznacza to, że wartość 1,0 odpowiada jednolitemu kolorowi, a wartość 0,0 – całkowicie przezroczystemu kolorowi.

Kontur

Kontur PageElement.

Jeśli te pola nie są ustawione, mogą być dziedziczone z nadrzędnego obiektu zastępczego, jeśli taki istnieje. Jeśli element nadrzędny nie istnieje, pola będą miały domyślnie wartość używaną w przypadku nowych elementów strony utworzonych w edytorze Prezentacji, która może zależeć od rodzaju elementu strony.

Zapis JSON
{
  "outlineFill": {
    object (OutlineFill)
  },
  "weight": {
    object (Dimension)
  },
  "dashStyle": enum (DashStyle),
  "propertyState": enum (PropertyState)
}
Pola
outlineFill

object (OutlineFill)

Wypełnienie obrysu.

weight

object (Dimension)

Grubość obrysu.

dashStyle

enum (DashStyle)

Styl linii przerywanej obrysu.

propertyState

enum (PropertyState)

Stan właściwości konturu.

Aktualizacja konturu elementu strony spowoduje niejawne zaktualizowanie tego pola do wartości RENDERED, chyba że w tej samej prośbie zostanie podana inna wartość. Aby element strony nie miał konturu, ustaw to pole na NOT_RENDERED. W takim przypadku wszystkie inne pola konturu ustawione w tej samej prośbie zostaną zignorowane.

OutlineFill

Wypełnienie obrysu.

Zapis JSON
{

  // Union field kind can be only one of the following:
  "solidFill": {
    object (SolidFill)
  }
  // End of list of possible types for union field kind.
}
Pola
Pole zbiorczekind. Rodzaj wypełnienia obrysu. kind może mieć tylko jedną z tych wartości:
solidFill

object (SolidFill)

Wypełnienie jednolitym kolorem.

DashStyle

Rodzaje kresek, za pomocą których można renderować geometrię liniową. Te wartości są oparte na typie prostym „ST_PresetLineDashVal” opisanym w sekcji 20.1.10.49 dokumentu „Office Open XML File Formats - Fundamentals and Markup Language Reference”, części 1 ECMA-376 w wersji 5.

Wartości w polu enum
DASH_STYLE_UNSPECIFIED Nieokreślony styl kreski.
SOLID Linia ciągła. Odpowiada wartości „solid” w ECMA-376 ST_PresetLineDashVal. Jest to domyślny styl linii przerywanej.
DOT Linia przerywana. Odpowiada wartości „dot” w ECMA-376 ST_PresetLineDashVal.
DASH Linia przerywana. Odpowiada wartości „dash” w ECMA-376 ST_PresetLineDashVal.
DASH_DOT Na przemian kreski i kropki. Odpowiada wartości „dashDot” w ECMA-376 ST_PresetLineDashVal.
LONG_DASH Linia z dużymi kreskami. Odpowiada wartości „lgDash” w ECMA-376 ST_PresetLineDashVal.
LONG_DASH_DOT Na przemian duże kreski i kropki. Odpowiada wartości „lgDashDot” w ECMA-376 ST_PresetLineDashVal.

Cień

Właściwości cienia elementu strony.

Jeśli te pola nie są ustawione, mogą być dziedziczone z nadrzędnego obiektu zastępczego, jeśli taki istnieje. Jeśli element nadrzędny nie istnieje, pola będą miały domyślnie wartość używaną w przypadku nowych elementów strony utworzonych w edytorze Prezentacji, która może zależeć od rodzaju elementu strony.

Zapis JSON
{
  "type": enum (Type),
  "transform": {
    object (AffineTransform)
  },
  "alignment": enum (RectanglePosition),
  "blurRadius": {
    object (Dimension)
  },
  "color": {
    object (OpaqueColor)
  },
  "alpha": number,
  "rotateWithShape": boolean,
  "propertyState": enum (PropertyState)
}
Pola
type

enum (Type)

Typ cienia. Ta właściwość jest tylko do odczytu.

transform

object (AffineTransform)

Przekształcenie, które koduje przesunięcie, skalę i pochylenie cienia względem pozycji wyrównania.

alignment

enum (RectanglePosition)

Punkt wyrównania cienia, który określa punkt początkowy dla przesunięcia, skalowania i pochylenia cienia. Ta właściwość jest tylko do odczytu.

blurRadius

object (Dimension)

Promień rozmycia cienia. Im większy promień, tym bardziej rozproszony cień.

color

object (OpaqueColor)

Wartość koloru cienia.

alpha

number

Wartość alfa koloru cienia w zakresie od 0,0 do 1,0.

rotateWithShape

boolean

Określa, czy cień ma się obracać wraz z kształtem. Ta właściwość jest tylko do odczytu.

propertyState

enum (PropertyState)

Stan właściwości cienia.

Aktualizacja cienia elementu strony spowoduje niejawne zaktualizowanie tego pola do wartości RENDERED, chyba że w tym samym żądaniu zostanie podana inna wartość. Aby element strony nie miał cienia, ustaw to pole na NOT_RENDERED. W takim przypadku wszystkie inne pola cienia ustawione w tym samym żądaniu zostaną zignorowane.

Typ

Typy cieni.

Wartości w polu enum
SHADOW_TYPE_UNSPECIFIED Nieokreślony typ cienia.
OUTER Cień zewnętrzny.

RectanglePosition

Definiuje pozycje odniesienia w prostokącie.

Wartości w polu enum
RECTANGLE_POSITION_UNSPECIFIED Nie określono.
TOP_LEFT W lewy górny róg.
TOP_CENTER U góry pośrodku.
TOP_RIGHT W prawy górny róg.
LEFT_CENTER Pośrodku z lewej strony.
CENTER Na środku.
RIGHT_CENTER Pośrodku z prawej strony.
BOTTOM_LEFT W lewy dolny róg.
BOTTOM_CENTER U dołu pośrodku.
BOTTOM_RIGHT W prawy dolny róg.

ContentAlignment

Typy wyrównania treści.

Pochodzi z podzbioru wartości typu prostego „ST_TextAnchoringType” w sekcji 20.1.10.60 dokumentu „Office Open XML File Formats - Fundamentals and Markup Language Reference”, część 1 ECMA-376 5th edition.

Wartości w polu enum
CONTENT_ALIGNMENT_UNSPECIFIED Nieokreślone wyrównanie treści. Wyrównanie treści jest dziedziczone z elementu nadrzędnego, jeśli istnieje.
CONTENT_ALIGNMENT_UNSUPPORTED Nieobsługiwane wyrównanie treści.
TOP Wyrównanie, które wyrównuje treść do góry kontenera treści. Odpowiada typowi ECMA-376 ST_TextAnchoringType „t”.
MIDDLE Wyrównanie, które wyrównuje treść do środka kontenera treści. Odpowiada typowi ECMA-376 ST_TextAnchoringType „ctr”.
BOTTOM Wyrównanie, które wyrównuje treść do dołu kontenera treści. Odpowiada typowi ECMA-376 ST_TextAnchoringType „b”.

Obiekt zastępczy

Informacje o obiekcie zastępczym, które jednoznacznie identyfikują kształt obiektu zastępczego.

Zapis JSON
{
  "type": enum (Type),
  "index": integer,
  "parentObjectId": string
}
Pola
type

enum (Type)

Typ symbolu zastępczego.

index

integer

Indeks elementu zastępczego. Jeśli na tej samej stronie występują te same typy elementów zastępczych, będą one miały różne wartości indeksu.

parentObjectId

string

Identyfikator obiektu nadrzędnego symbolu zastępczego tego kształtu. Jeśli nie jest ustawiony, kształt zastępczy elementu nadrzędnego nie istnieje, więc kształt nie dziedziczy właściwości z żadnego innego kształtu.

Typ

Typ kształtu symbolu zastępczego.

Wiele z tych typów zmiennych odpowiada identyfikatorom zmiennych ze standardu ECMA-376. Więcej informacji znajdziesz w opisie typu „ST_PlaceholderType” w sekcji 19.7.10 dokumentu „Office Open XML File Formats - Fundamentals and Markup Language Reference”, części 1 ECMA-376 5th edition.

Wartości w polu enum
NONE Wartość domyślna, która oznacza, że nie jest to obiekt zastępczy.
BODY Treść.
CHART wykres.
CLIP_ART Obraz clip art.
CENTERED_TITLE Tytuł wyśrodkowany.
DIAGRAM Diagram.
DATE_AND_TIME datę i godzinę;
FOOTER Tekst stopki.
HEADER Tekst nagłówka.
MEDIA Multimedia.
OBJECT Dowolny typ treści.
PICTURE Obraz.
SLIDE_NUMBER Numer slajdu.
SUBTITLE Podtytuł.
TABLE Tabela.
TITLE Tytuł slajdu.
SLIDE_IMAGE Obraz slajdu.

ImageProperties

Właściwości elementu Image.

Zapis JSON
{
  "cropProperties": {
    object (CropProperties)
  },
  "transparency": number,
  "brightness": number,
  "contrast": number,
  "recolor": {
    object (Recolor)
  },
  "outline": {
    object (Outline)
  },
  "shadow": {
    object (Shadow)
  },
  "link": {
    object (Link)
  }
}
Pola
cropProperties

object (CropProperties)

Właściwości przycięcia obrazu. Jeśli nie jest ustawiona, obraz nie jest przycinany. Ta właściwość jest tylko do odczytu.

transparency

number

Efekt przezroczystości obrazu. Wartość powinna mieścić się w przedziale [0,0, 1,0], gdzie 0 oznacza brak efektu, a 1 – całkowitą przezroczystość. Ta właściwość jest tylko do odczytu.

brightness

number

Efekt jasności obrazu. Wartość powinna mieścić się w przedziale [-1,0, 1,0], gdzie 0 oznacza brak efektu. Ta właściwość jest tylko do odczytu.

contrast

number

Efekt kontrastu obrazu. Wartość powinna mieścić się w przedziale [-1,0, 1,0], gdzie 0 oznacza brak efektu. Ta właściwość jest tylko do odczytu.

recolor

object (Recolor)

Efekt ponownego kolorowania obrazu. Jeśli nie zostanie ustawiona, obraz nie zostanie ponownie pokolorowany. Ta właściwość jest tylko do odczytu.

outline

object (Outline)

Kontur obrazu. Jeśli nie skonfigurujesz tej zasady, obraz nie będzie miał konturu.

shadow

object (Shadow)

Cień obrazu. Jeśli nie zostanie ustawiony, obraz nie będzie miał cienia. Ta właściwość jest tylko do odczytu.

CropProperties

Właściwości przycinania obiektu zamkniętego w kontenerze. Na przykład Image.

Właściwości przycięcia są reprezentowane przez przesunięcia 4 krawędzi, które określają prostokąt przycięcia. Przesunięcia są mierzone w procentach od odpowiednich krawędzi pierwotnego prostokąta ograniczającego obiektu w kierunku jego wnętrza, w stosunku do pierwotnych wymiarów obiektu.

  • Jeśli przesunięcie mieści się w przedziale (0, 1), odpowiednia krawędź prostokąta przycinania jest umieszczona wewnątrz oryginalnego prostokąta ograniczającego obiektu.
  • Jeśli przesunięcie jest ujemne lub większe niż 1, odpowiednia krawędź prostokąta przycinania jest umieszczana poza oryginalnym prostokątem ograniczającym obiektu.
  • Jeśli lewa krawędź prostokąta kadrowania znajduje się po prawej stronie jego prawej krawędzi, obiekt zostanie odwrócony w poziomie.
  • Jeśli górna krawędź prostokąta przycinania znajduje się poniżej dolnej krawędzi, obiekt zostanie odwrócony w pionie.
  • Jeśli wszystkie przesunięcia i kąt obrotu wynoszą 0, obiekt nie jest przycinany.

Po przycięciu zawartość w prostokącie przycięcia zostanie rozciągnięta, aby dopasować się do kontenera.

Zapis JSON
{
  "leftOffset": number,
  "rightOffset": number,
  "topOffset": number,
  "bottomOffset": number,
  "angle": number
}
Pola
leftOffset

number

Przesunięcie określa lewą krawędź prostokąta przycięcia, która znajduje się po prawej stronie lewej krawędzi oryginalnego prostokąta ograniczającego, względem pierwotnej szerokości obiektu.

rightOffset

number

Przesunięcie określa prawą krawędź prostokąta przycięcia, która znajduje się po lewej stronie prawej krawędzi oryginalnego prostokąta ograniczającego, względem pierwotnej szerokości obiektu.

topOffset

number

Przesunięcie określa górną krawędź prostokąta przycinania, która znajduje się poniżej górnej krawędzi oryginalnego prostokąta ograniczającego, względem pierwotnej wysokości obiektu.

bottomOffset

number

Przesunięcie określa dolną krawędź prostokąta przycinania, która znajduje się powyżej dolnej krawędzi oryginalnego prostokąta ograniczającego, w stosunku do pierwotnej wysokości obiektu.

angle

number

Kąt obrotu okna przycinania wokół jego środka w radianach. Kąt obrotu jest stosowany po przesunięciu.

Paleta kolorów

Efekt ponownego kolorowania zastosowany na obrazie.

Zapis JSON
{
  "recolorStops": [
    {
      object (ColorStop)
    }
  ],
  "name": enum (Name)
}
Pola
recolorStops[]

object (ColorStop)

Efekt zmiany koloru jest reprezentowany przez gradient, czyli listę punktów kolorów.

Kolory gradientu zastąpią odpowiednie kolory w palecie kolorów w tej samej pozycji i zostaną zastosowane do obrazu. Ta właściwość jest tylko do odczytu.

name

enum (Name)

Nazwa efektu zmiany koloru.

Nazwa jest określana na podstawie elementu recolorStops przez dopasowanie gradientu do kolorów w bieżącym elemencie color scheme na stronie. Ta właściwość jest tylko do odczytu.

ColorStop

Kolor i pozycja w pasku gradientu.

Zapis JSON
{
  "color": {
    object (OpaqueColor)
  },
  "alpha": number,
  "position": number
}
Pola
color

object (OpaqueColor)

Kolor punktu gradientu.

alpha

number

Wartość alfa tego koloru w pasku gradientu. Domyślna wartość to 1, 0 (pełna nieprzezroczystość).

position

number

Względna pozycja punktu koloru w pasku gradientu mierzona w procentach. Wartość powinna mieścić się w przedziale [0,0, 1,0].

Nazwa

Nazwy efektów zmiany koloru.

Wartości w polu enum
NONE Brak efektu zmiany palety kolorów. Wartość domyślna.
LIGHT1 Efekt zmiany koloru, który rozjaśnia obraz za pomocą pierwszego dostępnego koloru ze schematu kolorów strony.
LIGHT2 Efekt zmiany koloru, który rozjaśnia obraz przy użyciu drugiego dostępnego koloru strony z jej schematu kolorów.
LIGHT3 Efekt zmiany koloru, który rozjaśnia obraz za pomocą trzeciego dostępnego koloru strony z jej schematu kolorów.
LIGHT4 Efekt zmiany koloru, który rozjaśnia obraz za pomocą czwartego dostępnego koloru na stronie z jej schematu kolorów.
LIGHT5 Efekt zmiany koloru, który rozjaśnia obraz przy użyciu piątego dostępnego koloru na stronie z jej schematu kolorów.
LIGHT6 Efekt zmiany koloru, który rozjaśnia obraz za pomocą szóstego dostępnego koloru na stronie z jej schematu kolorów.
LIGHT7 Efekt zmiany koloru, który rozjaśnia obraz za pomocą siódmego dostępnego koloru na stronie z jej schematu kolorów.
LIGHT8 Efekt zmiany koloru, który rozjaśnia obraz za pomocą ósmego dostępnego koloru na stronie z jej schematu kolorów.
LIGHT9 Efekt zmiany koloru, który rozjaśnia obraz przy użyciu dziewiątego dostępnego koloru na stronie z jej schematu kolorów.
LIGHT10 Efekt zmiany koloru, który rozjaśnia obraz przy użyciu dziesiątego dostępnego koloru ze schematu kolorów strony.
DARK1 Efekt zmiany koloru, który przyciemnia obraz, używając pierwszego dostępnego koloru ze schematu kolorów strony.
DARK2 Efekt zmiany koloru, który przyciemnia obraz, używając drugiego dostępnego koloru strony z jej schematu kolorów.
DARK3 Efekt zmiany koloru, który przyciemnia obraz za pomocą trzeciego dostępnego koloru strony z jej schematu kolorów.
DARK4 Efekt zmiany koloru, który przyciemnia obraz, używając czwartego dostępnego koloru strony z jej schematu kolorów.
DARK5 Efekt zmiany koloru, który przyciemnia obraz przy użyciu piątego dostępnego koloru strony z jej schematu kolorów.
DARK6 Efekt zmiany koloru, który przyciemnia obraz za pomocą szóstego dostępnego koloru na stronie z jej schematu kolorów.
DARK7 Efekt zmiany koloru, który przyciemnia obraz za pomocą siódmego dostępnego koloru na stronie z jej schematu kolorów.
DARK8 Efekt zmiany koloru, który przyciemnia obraz za pomocą ósmego dostępnego koloru na stronie z jej schematu kolorów.
DARK9 Efekt zmiany koloru, który przyciemnia obraz przy użyciu dziewiątego dostępnego koloru na stronie z jej schematu kolorów.
DARK10 Efekt zmiany koloru, który przyciemnia obraz, używając dziesiątego dostępnego koloru strony z jej schematu kolorów.
GRAYSCALE Efekt ponownego kolorowania, który zmienia kolor obrazu na odcienie szarości.
NEGATIVE Efekt zmiany koloru, który zmienia kolor obrazu na negatyw w skali szarości.
SEPIA Efekt ponownego kolorowania, który zmienia kolor obrazu na sepię.
CUSTOM Efekt niestandardowego ponownego kolorowania. Konkretny gradient znajdziesz w sekcji recolorStops.