StyleLibrary

2024년 9월 3일

Library "StyleLibrary"
A small library of Pine Script functions that return built-in style variables.

method sizeStyle(size)
  Takes a `string` that returns the corresponding built-in size style variable.
  Namespace types: series string, simple string, input string, const string
  Parameters:
    size (string): A `string` representing a built-in size style: `"Tiny"`, `"Small"`, `"Normal"`, `"Large"`,
`"Huge"`, `"Auto"`.
  Returns: The respective built-in size style variable.

method sizeStyle(size)
  Takes a `sizeStyle` that returns the corresponding built-in size style variable.
  Namespace types: series sizeStyle
  Parameters:
    size (series sizeStyle): A `sizeStyle` representing a built-in size style variable.
  Returns: The respective built-in size style variable.

method lineStyle(style)
  Takes a `string` that returns the corresponding built-in line style variable.
  Namespace types: series string, simple string, input string, const string
  Parameters:
    style (string): A `string` representing a built-in line style: `"Dashed"`, `"Dotted"`, `"Solid"`.
  Returns: The respective built-in line style variable.

method lineStyle(style)
  Takes a `lineStyle` that returns the corresponding built-in line style variable.
  Namespace types: series lineStyle
  Parameters:
    style (series lineStyle): A `lineStyle` representing a built-in line style variable.
  Returns: The respective built-in line style variable.

method labelStyle(style)
  Takes a `string` that returns the corresponding built-in label style variable.
  Namespace types: series string, simple string, input string, const string
  Parameters:
    style (string): A `string` representing a built-in label style:
`"Arrow Down"`, `"Arrow Up"`, `"Circle"`, `"Cross"`, `"Diamond"`, `"Flag"`,
`"Label Center"`, `"Label Down"`, `"Label Left"`, `"Label Lower Left"`,
`"Label Lower Right"`, `"Label Right"`, `"Label Up"`, `"Label Upper Left"`,
`"Label Upper Right"`, `"None"`, `"Square"`, `"Text Outline"`, `"Triangle Down"`,
`"Triangle Up"`, `"XCross"`.
  Returns: The respective built-in label style variable.

method labelStyle(style)
  Takes a `labelStyle` that returns the corresponding built-in label style variable.
  Namespace types: series labelStyle
  Parameters:
    style (series labelStyle): A `labelStyle` representing a built-in label style variable.
  Returns: The respective built-in label style variable.

method fontStyle(font)
  Takes a `string` that returns the corresponding built-in font style variable.
  Namespace types: series string, simple string, input string, const string
  Parameters:
    font (string): A `string` representing a built-in font style: `"Default"`, `"Monospace"`.
  Returns: The respective built-in font style variable.

method positionStyle(position)
  Takes a `string` that returns the corresponding built-in position style variable.
  Namespace types: series string, simple string, input string, const string
  Parameters:
    position (string): A `string` representing a built-in position style:
`"Bottom Center", `"Bottom Left", `"Bottom Right", `"Middle Center", `"Middle Left",
`"Middle Right", `"Top Center", `"Top Left", `"Top Right".
  Returns: The respective built-in position style variable.

method displayStyle(display)
  Takes a `simple string` that returns the corresponding built-in display style variable.
  Namespace types: simple string, input string, const string
  Parameters:
    display (simple string): A `simple string` representing a built-in display style: `"All"`, `"Data Window"`,
`"None"`, `"Pane"`, `"Price Scale"`, `"Status Line"`.
  Returns: The respective built-in display style variable.

1월 8일

릴리즈 노트

v2

• 6️⃣ Update StyleLibrary for Pine Script™ v6.
  
• 🆕 Enumerations for styling the box border, extend, font, position, text align, and text wrap parameters of drawings.
  
• 🆕 Function methods for styling with strings or enumerations.
  
• 🏫 A "Usage" section at the bottom of the function preview hover with an small example of how to use the library.
  
• 🧵 All string parameters are no longer case sensitive.
  
• 🧾 A "Used in..." section in the function preview hover to see which built-in functions have parameters that use a given styling function's output.
  
• 🪂 Calling a StyleLibrary function using a string method with a misspelt or empty string will fallback on and return the same default styles used in corresponding built-in functions.
  
• 📜 Specifying MIT License. StyleLibrary v1 had no license.
  
• 🔄 Remove "Style" from the name of all functions.
  

3월 1일

릴리즈 노트

v3

Added:
method plot(style)
  Takes a const string input and matches a built-in plot style.

Used in the `style` parameter for
[plot()](tradingview.com/pine-script-reference/v6/
  Namespace types: simple plotStyleEnum
  Parameters:
    style (simple plotStyleEnum): A `simple plotStyleEnum` (or input) representing a built-in plot style variable.
  Returns: A built-in `plot` style constant.

**Usage**
```
plotInput = input.enum(sty.plotStyleEnum.solid, 'Plot Style')
newPlotStyle = sty.plot(plotStyleInput)
```

3월 1일

릴리즈 노트

v4

Updated:
method plot(style)
  Takes a const string input and matches a built-in plot style.

Used in the `style` parameter for
[plot()](tradingview.com/pine-script-reference/v6/
  Namespace types: simple plotEnum
  Parameters:
    style (simple plotEnum): A `simple plotEnum` (or input) representing a built-in plot style variable.
  Returns: A built-in `plot` style constant.

**Usage**
```
plotInput = input.enum(sty.plotEnum.solid, 'Plot Style')
newPlotStyle = sty.plot(plotStyleInput)
```

3월 1일

릴리즈 노트

v5

Added:
method plotStyle(style)
  Takes a const string input and matches a built-in plot style.

Used in the `style` parameter for
[plot()](tradingview.com/pine-script-reference/v6/
  Namespace types: simple plotEnum
  Parameters:
    style (simple plotEnum): A `simple plotEnum` (or input) representing a built-in plot style variable.
  Returns: A built-in `plot` style constant.

**Usage**
```
plotInput = input.enum(sty.plotEnum.solid, 'Plot Style')
newPlotStyle = sty.plot(plotStyleInput)
```

Removed:
method plot(style)
  Takes a const string input and matches a built-in plot style.

Used in the `style` parameter for
[plot()](tradingview.com/pine-script-reference/v6/

릴리즈 노트

v6
Replace Size() with sizeConst() (returns a built-in string const size style variable) and sizeNumeric() (returns an int for size parameters and can be used for custom sizing). Also updated textFormat() and added another method to it for bools instead of strings.

method sizeConst(style)
  Takes a `sizeEnum` and returns the corresponding built-in size `const string` style variable.
  Namespace types: series sizeEnum
  Parameters:
    style (series sizeEnum): A `sizeEnum` representing a built-in size style variable.
  Returns: The respective built-in size style variable.

method sizeNumeric(style, sizes)
  Takes a `sizeEnum` and returns an `int` numeric size.
  Namespace types: series sizeEnum
  Parameters:
    style (series sizeEnum): A `sizeEnum` representing a built-in or custom size.
    sizes (sizeNumericType): A `sizeNumericType` that holds custom numeric size `int` values for each of the built-in
sizes and a custom numeric size.
  Returns: An `int` representing a numeric size for `box`, `table`, or `label` text.

sizeNumericType
  A type for custom numeric size values.
  Fields:
    tiny (series int): Numeric size of the tiny size. Using `7` for labels, `8` for boxes and tables is recommended. Default is `8`.
    small (series int): Numeric size of the small size. Using `10` for labels, boxes, and tables is recommended. Default is `10`.
    normal (series int): Numeric size of the normal size. Using `12` for labels, or `14` for boxes and tables is recommended. Default is `14`.
    large (series int): Numeric size of the large size. Using `18` for labels, or `20` for boxes and tables is recommended. Default is `20`.
    huge (series int): Numeric size of the huge size. Using `24` for labels, or `36` for boxes and tables is recommended. Default is `36`.
    auto (series int): Numeric size of the auto size. Using `0` for labels, boxes, and tables is recommended. Default is `0`.
    custom (series int): Numeric size of a custom size. Default is `14`.

Updated:
method textFormat(bold, italic)
  Takes two `simple bool` inputs and returns the corresponding built-in text format style variable.
  Namespace types: simple bool, input bool, const bool
  Parameters:
    bold (simple bool): A `simple bool` representing the `text.format_bold` built-in text format style.
    italic (simple bool): A `simple bool` representing the `text.format_italic` built-in text format style.

Strings are not case sensitive. Default is `''`.
  Returns: The respective built-in text format style variable. When both inputs are `false`,
`textFormat()` returns `text.format_none`.

Removed:
method Size(style)