Class: Layout::LinearDimension

Inherits:
Entity
  • Object
show all
Defined in:
lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb

Overview

References a linear dimension entity. A LinearDimension is composed of the following sub-entities:

  • two ‘extension lines’ that connect to the Entity being dimensioned.

  • a ‘dimension line’ connecting the ends of the leaders. This may be represented by one or two Paths depending on appearance.

  • an optional ‘leader line’ that is used for small LinearDimensions.

  • a ‘dimension text’ that displays the LinearDimension‘s text.

There are six points that may be modified for a LinearDimension:

  • two ‘connection points’ that define the start and end of the LinearDimension.

  • two ‘extent points’ that define the start and end of the dimension line and are the ends of the two extension lines.

  • two ‘offset points’ that define the starting points of the extension lines.

Version:

  • LayOut 2018

Constant Summary collapse

LEADER_LINE_TYPE_BEZIER =

Constants

nil
LEADER_LINE_TYPE_HIDDEN =

Stub value.

nil
LEADER_LINE_TYPE_SINGLE_SEGMENT =

Stub value.

nil
LEADER_LINE_TYPE_TWO_SEGMENT =

Stub value.

nil

Instance Method Summary collapse

Methods inherited from Entity

#==, #bounds, #document, #drawing_bounds, #group, #layer_instance, #locked=, #locked?, #move_to_group, #move_to_layer, #on_shared_layer?, #page, #style, #style=, #transform!, #transformation, #untransformed_bounds, #untransformed_bounds=

Constructor Details

#initialize(start_point, end_point, height) ⇒ Layout::LinearDimension

The #initialize method creates a new disconnected Layout::LinearDimension.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)

Parameters:

Version:

  • LayOut 2018



316
317
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 316

def initialize(start_point, end_point, height)
end

Instance Method Details

#auto_scale=(uses_auto_scale) ⇒ Object

The #auto_scale= method sets whether the scale for the Layout::LinearDimension is set automatically.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
dim.auto_scale = true

Parameters:

  • uses_auto_scale (Boolean)

Raises:

Version:

  • LayOut 2018



50
51
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 50

def auto_scale=(uses_auto_scale)
end

#auto_scale? ⇒ Boolean

The #auto_scale? method returns whether the scale for the Layout::LinearDimension is set automatically.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
uses_auto_scale = dim.auto_scale?

Returns:

  • (Boolean)

Version:

  • LayOut 2018



66
67
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 66

def auto_scale?
end

#connect(start_connection, end_connection) ⇒ Object

The #connect method connects the Layout::LinearDimension to one or two Entitys using the provided ConnectionPoints. The Layout::LinearDimension must be in the same Document as the Entitys, and on the same Page if the Entitys are on non-shared Layout::Layers.

Examples:

doc = Layout::Document.open("C:/path/to/document.layout")
point_1 = Geom::Point2d.new(5, 7.5)
point_2 = Geom::Point2d.new(8.5, 9)
table = Layout::Rectangle.new([point_1, point_2])
doc.add_entity(table, @doc.layers.first, @doc.pages.first)
start_point = Layout::ConnectionPoint.new(table, point_1)
end_point = Layout::ConnectionPoint.new(table, point_2)
height = 1.0
dim = Layout::LinearDimension.new(Geom::Point2d.new(1, 1),
  Geom::Point2d.new(5, 5), height)
dim.connect(start_point, end_point)

Parameters:

Raises:

Version:

  • LayOut 2018



98
99
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 98

def connect(start_connection, end_connection)
end

#custom_text=(uses_custom_text) ⇒ Object

The #custom_text= method sets whether the Layout::LinearDimension uses custom text. When true, the Layout::LinearDimension will display a custom string that doesn’t change. When false, it will display the length measurement and will update automatically.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
dim.custom_text = true

Parameters:

  • uses_custom_text (Boolean)

Raises:

Version:

  • LayOut 2018



121
122
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 121

def custom_text=(uses_custom_text)
end

#custom_text? ⇒ Boolean

The #custom_text? method returns whether the Layout::LinearDimension uses custom text. When true, the Layout::LinearDimension will display a custom string that doesn’t change. When false, it will display the length measurement and will update automatically.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
# returns false
uses_custom_text = dim.custom_text?

Returns:

  • (Boolean)

Version:

  • LayOut 2018



140
141
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 140

def custom_text?
end

#disconnect ⇒ Object

The #disconnect method disconnects the Layout::LinearDimension from its ConnectionPoints. The dimension will not be adjusted by disconnecting from its ConnectionPoints.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
dim.disconnect

Raises:

Version:

  • LayOut 2018



160
161
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 160

def disconnect
end

#end_connection_point ⇒ Geom::Point2d

The #end_connection_point method returns the paper space location for the second connection.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
end_connection = dim.end_connection_point

Returns:

Version:

  • LayOut 2018



176
177
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 176

def end_connection_point
end

#end_connection_point=(end_point) ⇒ Object

The #end_connection_point= method sets the paper space location for the second connection.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
dim.end_connection_point = Geom::Point2d.new(6, 6)

Parameters:

Raises:

Version:

  • LayOut 2018



197
198
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 197

def end_connection_point=(end_point)
end

#end_extent_point ⇒ Geom::Point2d

The #end_extent_point method returns the paper space location for the end of the dimension line.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
end_ext_point = dim.end_extent_point

Returns:

Version:

  • LayOut 2018



213
214
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 213

def end_extent_point
end

#end_extent_point=(end_extent) ⇒ Object

The #end_extent_point= method sets the paper space location for the end of the dimension line.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
end_ext_point = Geom::Point2d.new(5, 6)
dim.end_extent_point = end_ext_point

Parameters:

Raises:

Version:

  • LayOut 2018



235
236
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 235

def end_extent_point=(end_extent)
end

#end_offset_length=(offset_length) ⇒ Object

The #end_offset_length= method sets the length of the offset from the second ConnectionPoint to the start of the second extension line. The ConnectionPoint and extent point will not move.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
end_ext_point = Geom::Point2d.new(5, 6)
dim.end_offset_length = 0.5

Parameters:

Raises:

Version:

  • LayOut 2018



258
259
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 258

def end_offset_length=(offset_length)
end

#end_offset_point ⇒ Geom::Point2d

The #end_offset_point method returns the paper space location for the end of the first extension line. The first extension line runs from this offset point to the end extent point.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
end_offset = dim.end_offset_point

Returns:

Version:

  • LayOut 2018



275
276
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 275

def end_offset_point
end

#entities ⇒ Layout::Entities

The #entities method returns the Entities that represent the Layout::LinearDimension in its exploded form. Depending on the appearance of the Layout::LinearDimension, this may return anywhere from four to six Entitys: start extension line, end extension line, one or two dimension lines, dimension text, and optionally the leader line.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
entites = dim.entities

Returns:

Version:

  • LayOut 2018



294
295
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 294

def entities
end

#leader_line_type ⇒ Integer

The #leader_line_type method returns the type of leader line the Layout::LinearDimension is using.

The leader line type can be one of the following:

Layout::LinearDimension::LEADER_LINE_TYPE_SINGLE_SEGMENT
Layout::LinearDimension::LEADER_LINE_TYPE_TWO_SEGMENT
Layout::LinearDimension::LEADER_LINE_TYPE_BEZIER
Layout::LinearDimension::LEADER_LINE_TYPE_HIDDEN

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
type = dim.leader_line_type

Returns:

  • (Integer)

Version:

  • LayOut 2018



338
339
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 338

def leader_line_type
end

#leader_line_type=(type) ⇒ Object

The #leader_line_type= method sets the type of leader line the Layout::LinearDimension is using.

The leader line type can be one of the following:

Layout::LinearDimension::LEADER_LINE_TYPE_SINGLE_SEGMENT
Layout::LinearDimension::LEADER_LINE_TYPE_TWO_SEGMENT
Layout::LinearDimension::LEADER_LINE_TYPE_BEZIER
Layout::LinearDimension::LEADER_LINE_TYPE_HIDDEN

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
dim.leader_line_type = Layout::LinearDimension::LEADER_LINE_TYPE_BEZIER

Parameters:

  • type (Integer) —

    The leader line type

Raises:

Version:

  • LayOut 2018



368
369
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 368

def leader_line_type=(type)
end

#scale ⇒ Numeric

The #scale method returns the scale being used for the Layout::LinearDimension.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
scale = dim.scale

Returns:

Version:

  • LayOut 2018



384
385
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 384

def scale
end

#scale=(scale) ⇒ Object

The #scale= method sets the scale being used for the Layout::LinearDimension.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
dim.scale = 1.5

Parameters:

Raises:

Version:

  • LayOut 2018



407
408
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 407

def scale=(scale)
end

#start_connection_point ⇒ Geom::Point2d

The #start_connection_point method returns the paper space location for the first connection.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
start_connection = dim.start_connection_point

Returns:

Version:

  • LayOut 2018



423
424
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 423

def start_connection_point
end

#start_connection_point=(start_point) ⇒ Object

The #start_connection_point= method sets the paper space location for the first connection.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
dim.start_connection_point = Geom::Point2d.new(2, 2)

Parameters:

Raises:

Version:

  • LayOut 2018



444
445
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 444

def start_connection_point=(start_point)
end

#start_extent_point ⇒ Geom::Point2d

The #start_extent_point method returns the paper space location for the start of the dimension line.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
start_ext_point = dim.start_extent_point

Returns:

Version:

  • LayOut 2018



460
461
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 460

def start_extent_point
end

#start_extent_point=(start_extent) ⇒ Object

The #start_extent_point= method sets the paper space location for the start of the dimension line.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
start_ext_point = Geom::Point2d.new(2, 3)
dim.start_extent_point = start_ext_point

Parameters:

Raises:

Version:

  • LayOut 2018



482
483
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 482

def start_extent_point=(start_extent)
end

#start_offset_length=(offset_length) ⇒ Object

The #start_offset_length= method sets the length of the offset from the first ConnectionPoint to the start of the first extension line. The ConnectionPoint and extent point will not move.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
end_ext_point = Geom::Point2d.new(5, 6)
dim.start_offset_length = 0.5

Parameters:

Raises:

Version:

  • LayOut 2018



505
506
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 505

def start_offset_length=(offset_length)
end

#start_offset_point ⇒ Geom::Point2d

The #start_offset_point method returns the paper space location for the start of the first extension line. The first extension line runs from this offset point to the start extent point.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
start_offset = dim.start_offset_point

Returns:

Version:

  • LayOut 2018



522
523
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 522

def start_offset_point
end

#text ⇒ Layout::FormattedText

The #text method returns a copy of the Layout::LinearDimension‘s FormattedText.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
text = dim.text

Returns:

Version:

  • LayOut 2018



538
539
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 538

def text
end

#text=(formatted_text) ⇒ Object

The #text= method sets the Layout::LinearDimension‘s FormattedText.

Examples:

start_point = Geom::Point2d.new(1, 1)
end_point = Geom::Point2d.new(5, 5)
height = 1.0
dim = Layout::LinearDimension.new(start_point, end_point, height)
anchor_type = Layout::FormattedText::ANCHOR_TYPE_TOP_LEFT
dim.text = Layout::FormattedText.new("Hello LayOut", start_point, anchor_type)

Parameters:

Raises:

Version:

  • LayOut 2018



560
561
 
# File 'lib/sketchup-api-stubs/stubs/Layout/LinearDimension.rb', line 560

def text=(formatted_text)
end