matplotlib.patheffects#

경로 효과에 대한 클래스를 정의합니다. 경로 효과는 TextLine2D에서 지원됩니다 Patch.

또한보십시오

경로 효과 가이드

클래스 matplotlib.patheffects. AbstractPathEffect ( 오프셋 = (0.0, 0.0) ) [소스] #

베이스:object

경로 효과의 기본 클래스입니다.

draw_path하위 클래스는 효과 기능을 추가하기 위해 메서드를 재정의해야 합니다.

매개변수 :
오프셋 (float, float), 기본값: (0, 0)

경로에 적용할 (x, y) 오프셋으로 포인트 단위로 측정됩니다.

draw_path ( 렌더러 , gc , tpath , affine , rgbFace = None ) [소스] #

Derived는 이 메서드를 재정의해야 합니다. matplotlib.backend_bases.RendererBase.draw_path() 인수 는 첫 번째 인수가 렌더러라는 점 을 제외하고는 동일 합니다.

클래스 matplotlib.patheffects. 일반 ( 오프셋 = (0.0, 0.0) ) [소스] #

베이스:AbstractPathEffect

"정체성" PathEffect.

Normal PathEffect의 유일한 목적은 특별한 경로 효과 없이 원본 아티스트를 그리는 것입니다.

매개변수 :
오프셋 (float, float), 기본값: (0, 0)

경로에 적용할 (x, y) 오프셋으로 포인트 단위로 측정됩니다.

클래스 matplotlib.patheffects. PathEffectRenderer ( path_effects , 렌더러 ) [소스] #

베이스:RendererBase

다른 렌더러를 포함하는 렌더러를 구현합니다.

AbstractPathEffect그런 다음 이 프록시는 적절한 그리기 메서드 를 호출하여 그리기 호출을 가로챕 니다.

메모

이 RendererBase 하위 클래스에서 모든 메서드가 재정의된 것은 아닙니다. PathEffects 기능을 더 확장하려면 메서드를 더 추가해야 할 수도 있습니다.

매개변수 :
path_effects 반복 가능AbstractPathEffect

이 렌더러가 나타내는 경로 효과입니다.

렌더러 matplotlib.backend_bases.RendererBase서브클래스
copy_with_path_effect ( 경로 효과 ) [소스] #
draw_markers ( gc , marker_path , marker_trans , path , * args , ** kwargs ) [출처] #

경로 의 각 정점(제어점 제외) 에 마커를 그 립니다.

기본(대체) 구현은 draw_path. 백엔드는 마커를 한 번만 그리고 여러 번 재사용하기 위해 이 메서드를 재정의할 수 있습니다.

매개변수 :
gcGraphicsContextBase

그래픽 컨텍스트입니다.

marker_transmatplotlib.transforms.Transform

마커에 적용된 아핀 변환입니다.

트랜스matplotlib.transforms.Transform

경로에 적용된 아핀 변환입니다.

draw_path ( gc , tpath , affine , rgbFace = None ) [소스] #

Path주어진 아핀 변환을 사용하여 인스턴스를 그립니다 .

draw_path_collection ( gc , master_transform , paths , * args , ** kwargs ) [소스] #

경로 모음을 그 립니다.

각 경로는 먼저 all_transforms ((3, 3) 행렬 목록) 의 해당 항목에 의해 변환된 다음 master_transform 에 의해 변환됩니다 . 그런 다음 offset_trans 에 의해 처음 변환된 offsets 의 해당 항목에 의해 변환됩니다 .

facecolors , edgecolors , linewidths , linestylesantialiased 는 해당 속성을 설정하는 목록입니다.

offset_position 은 현재 사용되지 않지만 이전 버전과의 호환성을 위해 인수가 유지됩니다.

기본(대체) 구현은 draw_path. 백엔드는 각 경로 데이터 집합을 한 번만 렌더링하기 위해 이를 재정의하고 다른 오프셋, 색상, 스타일 등으로 해당 경로를 여러 번 참조할 수 있습니다. 생성기 메서드 는 구현을 지원( _iter_collection_raw_paths_iter_collection표준화)하기 위해 제공됩니다. 백엔드에서. 이러한 생성기를 사용하여 의 동작을 전역적으로 변경할 수 있도록 하는 것이 좋습니다 draw_path_collection.

클래스 matplotlib.patheffects. PathPatchEffect ( 오프셋 = (0, 0) , ** kwargs ) [소스] #

베이스:AbstractPathEffect

PathPatch경로가 원본 PathEffect 아티스트에서 오는 인스턴스를 그립니다 .

매개변수 :
오프셋 (float, float), 기본값: (0, 0)

경로에 적용할 (x, y) 오프셋(단위: 포인트)입니다.

**kwargs

PathPatch모든 키워드 인수는 생성자 로 전달됩니다 . 재정의할 수 없는 속성은 "path", "clip_box" "transform" 및 "clip_path"입니다.

draw_path ( 렌더러 , gc , tpath , affine , rgbFace ) [소스] #

Derived는 이 메서드를 재정의해야 합니다. matplotlib.backend_bases.RendererBase.draw_path() 인수 는 첫 번째 인수가 렌더러라는 점 을 제외하고는 동일 합니다.

클래스 matplotlib.patheffects. SimpleLineShadow ( offset = (2, -2) , shadow_color = 'k' , alpha = 0.3 , rho = 0.3 , ** kwargs ) [출처] #

베이스:AbstractPathEffect

선을 통한 단순한 그림자.

매개변수 :
오프셋 (float, float), 기본값: (2, -2)

경로에 적용할 (x, y) 오프셋(단위: 포인트)입니다.

shadow_color 색상, 기본값: '검은색'

그림자 색상입니다. 의 값은 스케일 팩터가 rhoNone 인 원본 아티스트의 색상을 사용합니다 .

알파 플로트, 기본값: 0.3

생성된 그림자 패치의 알파 투명도입니다.

rho 플로트, 기본값: 0.3

shadow_color가 인 경우 rgbFace 색상에 적용할 배율 인수 입니다 None.

**kwargs

추가 키워드가 저장되어 에 전달됩니다 AbstractPathEffect._update_gc().

draw_path ( 렌더러 , gc , tpath , affine , rgbFace ) [소스] #

표준 draw_path를 재정의하여 그림자 오프셋과 그림자에 필요한 색상 변경을 추가합니다.

클래스 matplotlib.patheffects. SimplePatchShadow ( offset = (2, -2) , shadow_rgbFace = None , alpha = None , rho = 0.3 , ** kwargs ) [출처] #

베이스:AbstractPathEffect

채워진 패치를 통한 간단한 그림자.

매개변수 :
오프셋 (float, float), 기본값: (2, -2)

포인트에서 그림자의 (x, y) 오프셋입니다.

shadow_rgb페이스 컬러

그림자 색상입니다.

알파 플로트, 기본값: 0.3

생성된 그림자 패치의 알파 투명도입니다.

rho 플로트, 기본값: 0.3

shadow_rgbFace가 지정되지 않은 경우 rgbFace 색상에 적용할 배율 인수 입니다.

**kwargs

추가 키워드가 저장되어 에 전달됩니다 AbstractPathEffect._update_gc().

draw_path ( 렌더러 , gc , tpath , affine , rgbFace ) [소스] #

표준 draw_path를 재정의하여 그림자 오프셋과 그림자에 필요한 색상 변경을 추가합니다.

클래스 matplotlib.patheffects. 스트로크 ( 오프셋 = (0, 0) , ** kwargs ) [소스] #

베이스:AbstractPathEffect

획을 다시 그리는 선 기반 PathEffect입니다.

경로는 주어진 키워드 인수로 업데이트된 gc로 표시됩니다. 즉, 키워드 인수는 유효한 gc 매개변수 값이어야 합니다.

draw_path ( 렌더러 , gc , tpath , affine , rgbFace ) [소스] #

업데이트된 gc로 경로를 그립니다.

클래스 matplotlib.patheffects. TickedStroke ( 오프셋 = (0, 0) , 간격 = 10.0 , 각도 = 45.0 , 길이 = 1.4142135623730951 , ** kwargs ) [출처] #

베이스:AbstractPathEffect

틱 스타일로 경로를 그리는 선 기반 PathEffect입니다.

이 선 스타일은 최적화에서 제약 조건을 나타내는 데 자주 사용됩니다. 눈금은 선의 한쪽이 유효하지 않음을 나타내거나 도메인의 닫힌 경계(예: 벽 또는 파이프 가장자리)를 나타내는 데 사용될 수 있습니다.

눈금의 간격, 길이 및 각도를 제어할 수 있습니다.

이 선 스타일을 해치선이라고도 합니다.

컨투어 데모 예제 도 참조하십시오 .

최적화 예제 의 등고선도 참조하십시오 .

매개변수 :
오프셋 (float, float), 기본값: (0, 0)

경로에 적용할 (x, y) 오프셋(단위: 포인트)입니다.

간격 부동, 기본값: 10.0

포인트의 눈금 사이의 간격입니다.

부동 각도 , 기본값: 45.0

경로와 눈금 사이의 각도(도)입니다. 각도는 0도가 바로 앞, 90도가 왼쪽, -90도가 오른쪽, 180도가 뒤를 가리키는 곡선을 따라 걷는 개미처럼 측정됩니다.

길이 부동, 기본값: 1.414

간격에 상대적인 눈금의 길이입니다. 권장 길이 = 각도=45일 때 1.414(sqrt(2)), 각도=90일 때 길이=1.0, 각도=60일 때 길이=2.0.

**kwargs

추가 키워드가 저장되어 에 전달됩니다 AbstractPathEffect._update_gc().

TickedStroke 경로 효과 를 참조하십시오 .

draw_path ( 렌더러 , gc , tpath , affine , rgbFace ) [소스] #

업데이트된 gc로 경로를 그립니다.

클래스 matplotlib.patheffects. withSimplePatchShadow ( offset = (2, -2) , shadow_rgbFace = None , alpha = None , rho = 0.3 , ** kwargs ) [소스] #

베이스:SimplePatchShadow

SimplePatchShadow원본 아티스트 를 적용한 다음 그리기 위한 바로 가기 PathEffect입니다 .

이 클래스를 사용하면 사용할 수 있습니다.

artist.set_path_effects([path_effects.withSimplePatchShadow()])

바로 가기로

artist.set_path_effects([path_effects.SimplePatchShadow(),
                         path_effects.Normal()])
매개변수 :
오프셋 (float, float), 기본값: (2, -2)

포인트에서 그림자의 (x, y) 오프셋입니다.

shadow_rgb페이스 컬러

그림자 색상입니다.

알파 플로트, 기본값: 0.3

생성된 그림자 패치의 알파 투명도입니다.

rho 플로트, 기본값: 0.3

shadow_rgbFace가 지정되지 않은 경우 rgbFace 색상에 적용할 배율 인수 입니다.

**kwargs

추가 키워드가 저장되어 에 전달됩니다 AbstractPathEffect._update_gc().

draw_path ( 렌더러 , gc , tpath , affine , rgbFace ) [소스] #

표준 draw_path를 재정의하여 그림자 오프셋과 그림자에 필요한 색상 변경을 추가합니다.

클래스 matplotlib.patheffects. withStroke ( 오프셋 = (0, 0) , ** kwargs ) [소스] #

베이스:Stroke

Stroke원본 아티스트 를 적용한 다음 그리기 위한 바로 가기 PathEffect입니다 .

이 클래스를 사용하면 사용할 수 있습니다.

artist.set_path_effects([path_effects.withStroke()])

바로 가기로

artist.set_path_effects([path_effects.Stroke(),
                         path_effects.Normal()])

경로는 주어진 키워드 인수로 업데이트된 gc로 표시됩니다. 즉, 키워드 인수는 유효한 gc 매개변수 값이어야 합니다.

draw_path ( 렌더러 , gc , tpath , affine , rgbFace ) [소스] #

업데이트된 gc로 경로를 그립니다.

클래스 matplotlib.patheffects. withTickedStroke ( 오프셋 = (0, 0) , 간격 = 10.0 , 각도 = 45.0 , 길이 = 1.4142135623730951 , ** kwargs ) [출처] #

베이스:TickedStroke

TickedStroke원본 아티스트 를 적용한 다음 그리기 위한 바로 가기 PathEffect입니다 .

이 클래스를 사용하면 사용할 수 있습니다.

artist.set_path_effects([path_effects.withTickedStroke()])

바로 가기로

artist.set_path_effects([path_effects.TickedStroke(),
                         path_effects.Normal()])
매개변수 :
오프셋 (float, float), 기본값: (0, 0)

경로에 적용할 (x, y) 오프셋(단위: 포인트)입니다.

간격 부동, 기본값: 10.0

포인트의 눈금 사이의 간격입니다.

부동 각도 , 기본값: 45.0

경로와 눈금 사이의 각도(도)입니다. 각도는 0도가 바로 앞, 90도가 왼쪽, -90도가 오른쪽, 180도가 뒤를 가리키는 곡선을 따라 걷는 개미처럼 측정됩니다.

길이 부동, 기본값: 1.414

간격에 상대적인 눈금의 길이입니다. 권장 길이 = 각도=45일 때 1.414(sqrt(2)), 각도=90일 때 길이=1.0, 각도=60일 때 길이=2.0.

**kwargs

추가 키워드가 저장되어 에 전달됩니다 AbstractPathEffect._update_gc().

TickedStroke 경로 효과 를 참조하십시오 .

draw_path ( 렌더러 , gc , tpath , affine , rgbFace ) [소스] #

업데이트된 gc로 경로를 그립니다.