matplotlib.backend_bases#

추상 기본 클래스는 렌더러 및 그래픽 컨텍스트가 Matplotlib 백엔드 역할을 하기 위해 구현해야 하는 프리미티브를 정의합니다.

RendererBase

그리기/렌더링 작업을 처리하는 추상 기본 클래스입니다.

FigureCanvasBase

Figure사용자 인터페이스 그리기 영역과 같은 백엔드 특정 세부 정보에서 분리하는 추상화 계층입니다 .

GraphicsContextBase

색상, 선 스타일 등을 제공하는 추상 기본 클래스입니다.

Event

모든 Matplotlib 이벤트 처리를 위한 기본 클래스입니다. 눌린 키 및 버튼, 픽셀 및 좌표 의 x 및 y 위치와 같은 메타 데이터와 KeyEvent같은 파생 클래스 .MouseEventAxes

ShowBase

Show각 대화형 백엔드 의 클래스에 대한 기본 클래스입니다 . 그러면 'show' 콜러블이 로 설정됩니다 Show.__call__.

ToolContainerBase

각 대화형 백엔드의 Toolbar 클래스에 대한 기본 클래스입니다.

클래스 matplotlib.backend_bases. CloseEvent ( name , canvas , guiEvent = None ) [소스] #

베이스:Event

닫히는 그림에 의해 트리거되는 이벤트입니다.

클래스 matplotlib.backend_bases. DrawEvent ( 이름 , 캔버스 , 렌더러 ) [소스] #

베이스:Event

캔버스에서 그리기 작업에 의해 트리거되는 이벤트입니다.

대부분의 백엔드에서 이 이벤트를 구독하는 콜백은 렌더링이 완료된 후 화면이 업데이트되기 전에 시작됩니다. 캔버스의 렌더러에 그려진 추가 아티스트는 에 대한 명시적인 호출 없이 반영됩니다 blit.

경고

canvas.draw이러한 콜백 에서 호출 canvas.blit하는 것은 모든 백엔드에서 안전하지 않을 수 있으며 무한 재귀를 유발할 수 있습니다.

DrawEvent에는 부모 Event클래스에 의해 정의된 것 외에도 많은 특수 속성이 있습니다.

속성 :
렌더러RendererBase

그리기 이벤트의 렌더러입니다.

클래스 matplotlib.backend_bases. 이벤트 ( name , canvas , guiEvent = None ) [소스] #

베이스:object

Matplotlib 이벤트.

다음 속성이 정의되고 기본값으로 표시됩니다. 하위 클래스는 추가 특성을 정의할 수 있습니다.

속성 :
이름 문자열

이벤트 이름입니다.

캔버스FigureCanvasBase

이벤트를 생성하는 백엔드별 캔버스 인스턴스입니다.

guiEvent

Matplotlib 이벤트를 트리거한 GUI 이벤트입니다.

클래스 matplotlib.backend_bases. FigureCanvasBase ( 그림 = 없음 ) [출처] #

베이스:object

그림이 렌더링되는 캔버스입니다.

속성 :
수치matplotlib.figure.Figure

높은 수준의 Figure 인스턴스입니다.

blit ( bbox = 없음 ) [소스] #

bbox에서 캔버스를 블리트합니다(기본적으로 전체 캔버스).

속성 button_pick_id #
button_press_event ( x , y , 버튼 , dblclick = False , guiEvent = 없음 ) [소스] #

[ Deprecated ] 마우스 버튼 누름 이벤트에 대한 콜백 처리.

백엔드 파생 클래스는 마우스 버튼을 누를 때마다 이 함수를 호출해야 합니다. ( x , y )는 캔버스 좌표입니다((0, 0)은 왼쪽 아래에 있음). 버튼과 키는 에 정의된 대로입니다 MouseEvent.

이 메서드는 'button_press_event'에 연결된 모든 함수를 MouseEvent인스턴스로 호출합니다.

메모

버전 3.6부터 폐지: 대신 callbacks.process('button_press_event', MouseEvent(...)) 를 사용하세요.

button_release_event ( x , y , 버튼 , guiEvent = 없음 ) [소스] #

[ Deprecated ] 마우스 버튼 해제 이벤트에 대한 콜백 처리.

백엔드 파생 클래스는 마우스 버튼을 놓을 때마다 이 함수를 호출해야 합니다.

이 메서드는 'button_release_event'에 연결된 모든 함수를 MouseEvent인스턴스로 호출합니다.

매개변수 :
x 플로트

캔버스 좌표는 0=왼쪽입니다.

y 플로트

캔버스 좌표는 0=바닥입니다.

guiEvent

Matplotlib 이벤트를 생성한 기본 UI 이벤트입니다.

메모

버전 3.6부터 폐지: 대신 callbacks.process('button_release_event', MouseEvent(...)) 를 사용하세요.

속성 콜백 #
close_event ( guiEvent = 없음 ) [소스] #

[ 비추천 ] CloseEvent에 연결된 모든 함수에 a를 전달합니다 close_event.

메모

버전 3.6부터 폐지: 대신 callbacks.process('close_event', CloseEvent(...)) 를 사용하세요.

속성 device_pixel_ratio #

화면의 캔버스에 사용되는 물리적 픽셀과 논리적 픽셀의 비율입니다.

기본적으로 이것은 1이며 물리적 및 논리적 픽셀의 크기가 동일함을 의미합니다. 높은 DPI 화면을 지원하는 하위 클래스는 이 속성을 설정하여 해당 비율이 다르다는 것을 나타낼 수 있습니다. 캔버스에서 직접 작업하지 않는 한 모든 Matplotlib 상호 작용은 논리 픽셀로 유지됩니다.

그리기 ( * 인수 , ** kwargs ) [출처] #

를 렌더링합니다 Figure.

이 메서드는 출력이 생성되지 않더라도 아티스트 트리를 탐색해야 합니다. 출력을 디스크에 저장하기 전에 사용자가 액세스하려는 지연된 작업을 트리거하기 때문입니다. 예를 들어 컴퓨팅 한계, 자동 한계 및 눈금 값.

draw_event ( 렌더러 ) [소스] #

[ 비추천 ] DrawEvent에 연결된 모든 함수에 a를 전달합니다 draw_event.

메모

버전 3.6부터 폐지: 대신 callbacks.process('draw_event', DrawEvent(...)) 를 사용하세요.

draw_idle ( * args , ** kwargs ) [출처] #

컨트롤이 GUI 이벤트 루프로 반환되면 위젯 다시 그리기를 요청합니다.

컨트롤이 GUI 이벤트 루프로 반환되기 전에 여러 호출이 발생하더라도 draw_idleFigure는 한 번만 렌더링됩니다.

메모

백엔드는 다중 렌더링을 방지하기 위해 메서드를 재정의하고 자체 전략을 구현하도록 선택할 수 있습니다.

enter_notify_event ( guiEvent = 없음 , xy = 없음 ) [소스] #

[ Deprecated ] 캔버스에 들어가는 마우스 커서에 대한 콜백 처리.

백엔드 파생 클래스는 캔버스에 들어갈 때 이 함수를 호출해야 합니다.

매개변수 :
guiEvent

Matplotlib 이벤트를 생성한 기본 UI 이벤트입니다.

xy (플로트, 플로트)

캔버스에 들어갈 때 포인터의 좌표 위치입니다.

메모

버전 3.6부터 사용되지 않음: 대신 callbacks.process('enter_notify_event', LocationEvent(...)) 를 사용하십시오.

이벤트 = ['resize_event', 'draw_event', 'key_press_event', 'key_release_event', 'button_press_event', 'button_release_event', 'scroll_event', 'motion_notify_event', 'pick_event', 'figure_enter_event', 'figure_leave_event', 'axes_enter_event' , 'axes_leave_event', 'close_event'] #
filetypes = {'eps': 'Encapsulated Postscript', 'jpeg': '공동 사진 전문가 그룹', 'jpg': '공동 사진 전문가 그룹', 'pdf': 'Portable Document Format', 'pgf': 'PGF LaTeX 용 코드 ', 'png': '이동식 네트워크 그래픽', 'ps': '포스트스크립트', 'raw': '원시 RGBA 비트맵', 'rgba': '원시 RGBA 비트맵','svg': '확장 가능한 벡터 그래픽', 'svgz': 'Scalable Vector Graphics', 'tif': 'Tagged Image File Format', 'tiff': 'Tagged Image File Format', 'webp': 'WebP 이미지 형식'} #
fixed_dpi = 없음 #
flush_events ( ) [출처] #

그림에 대한 GUI 이벤트를 플러시합니다.

대화형 백엔드는 이 방법을 다시 구현해야 합니다.

get_default_filename ( ) [소스] #

기본 파일 이름으로 사용하기에 적합한 확장자를 포함하는 문자열을 반환합니다.

classmethod get_default_filetype ( ) [소스] #

rcParams["savefig.format"](기본값: ) 에 지정된 대로 기본 savefig 파일 형식을 반환합니다 'png'.

반환된 문자열에는 마침표가 포함되어 있지 않습니다. 이 방법은 단일 파일 형식만 지원하는 백엔드에서 재정의됩니다.

classmethod get_supported_filetypes ( ) [출처] #

이 백엔드에서 지원하는 savefig 파일 형식의 사전을 반환합니다.

classmethod get_supported_filetypes_grouped ( ) [출처] #

이 백엔드에서 지원하는 savefig 파일 형식의 사전을 반환합니다. 여기서 키는 'Joint Photographic Experts Group'과 같은 파일 유형 이름이고 값은 ['jpg'와 같은 해당 파일 유형에 사용되는 파일 이름 확장자 목록입니다. , 'jpeg'].

get_width_height ( * , 물리적 = False ) [소스] #

숫자의 너비와 높이를 정수 포인트 또는 픽셀로 반환합니다.

그림이 높은 DPI 화면에서 사용되고 백엔드에서 지원되는 경우 장치 픽셀 비율로 크기를 조정한 후 정수로 잘림이 발생합니다.

매개변수 :
물리적 부울, 기본값: False

실제 물리적 픽셀 또는 논리적 픽셀을 반환할지 여부입니다. 물리적 픽셀은 HiDPI를 지원하는 백엔드에서 사용할 수 있지만 여전히 실제 크기를 사용하여 캔버스를 구성합니다.

반환 :
너비, 높이 정수

백엔드에 따라 그림의 크기(포인트 또는 픽셀)입니다.

grab_mouse ( ax ) [출처] #

Axes마우스 이벤트를 잡는 자식을 설정 합니다.

일반적으로 위젯 자체에서 호출합니다. 이미 다른 Axes가 마우스를 잡고 있는 경우 이를 호출하는 것은 오류입니다.

inaxes ( xy ) [출처] #

Axes포인트 xy 를 포함 하는 최상위 가시성을 반환합니다 .

매개변수 :
xy (플로트, 플로트)

(x, y) 캔버스 왼쪽/아래에서 픽셀 위치.

반환 :
Axes또는 없음

포인트를 포함하는 최상위 표시 Axes 또는 포인트에 Axes가 없는 경우 None입니다.

is_saving ( ) [출처] #

렌더러가 화면 버퍼용으로 렌더링하는 것이 아니라 파일에 저장하는 과정에 있는지 여부를 반환합니다.

key_press_event ( 키 , guiEvent = 없음 ) [소스] #

[ 비추천 ] KeyEvent에 연결된 모든 함수에 a를 전달합니다 key_press_event.

메모

버전 3.6부터 폐지됨: 대신 callbacks.process('key_press_event', KeyEvent(...)) 를 사용하십시오.

key_release_event ( 키 , guiEvent = 없음 ) [소스] #

[ 비추천 ] KeyEvent에 연결된 모든 함수에 a를 전달합니다 key_release_event.

메모

버전 3.6부터 폐지됨: 대신 callbacks.process('key_release_event', KeyEvent(...)) 를 사용하십시오.

leave_notify_event ( guiEvent = 없음 ) [출처] #

[ Deprecated ] 캔버스를 떠나는 마우스 커서에 대한 콜백 처리.

백엔드 파생 클래스는 캔버스를 떠날 때 이 함수를 호출해야 합니다.

매개변수 :
guiEvent

Matplotlib 이벤트를 생성한 기본 UI 이벤트입니다.

메모

버전 3.6부터 폐지: callbacks.process('leave_notify_event', LocationEvent(...)) 를 대신 사용하세요.

manager_class [소스] #

별칭FigureManagerBase

motion_notify_event ( x , y , guiEvent = 없음 ) [소스] #

[ Deprecated ] 마우스 이동 이벤트에 대한 콜백 처리.

백엔드 파생 클래스는 모든 모션 알림 이벤트에서 이 함수를 호출해야 합니다.

이 메서드는 'motion_notify_event'에 연결된 모든 함수를 MouseEvent인스턴스로 호출합니다.

매개변수 :
x 플로트

캔버스 좌표는 0=왼쪽입니다.

y 플로트

캔버스 좌표는 0=바닥입니다.

guiEvent

Matplotlib 이벤트를 생성한 기본 UI 이벤트입니다.

메모

버전 3.6부터 폐지됨: 대신 callbacks.process('motion_notify_event', MouseEvent(...)) 를 사용하십시오.

mpl_connect ( s , func ) [소스] #

함수 func 를 이벤트 s 에 바인딩합니다 .

매개변수 :
s str

다음 이벤트 ID 중 하나:

  • 'button_press_event'

  • '버튼_해제_이벤트'

  • '그리기 이벤트'

  • 'key_press_event'

  • 'key_release_event'

  • 'motion_notify_event'

  • 'pick_event'

  • 'resize_event'

  • 'scroll_event'

  • 'figure_enter_event',

  • 'figure_leave_event',

  • 'axes_enter_event',

  • 'axes_leave_event'

  • 'close_event'.

함수 호출 가능

실행할 콜백 함수는 서명이 있어야 합니다.

def func(event: Event) -> Any

위치 이벤트(버튼 및 키 누름/해제)의 경우 마우스가 Axes 위에 있으면 이벤트의 inaxes속성이 Axes이벤트 발생으로 설정되고 추가로 변수 xdata및 ydata속성이 마우스로 설정됩니다. 데이터 좌표의 위치. 자세한 내용은 KeyEvent 및 MouseEvent을 참조하십시오.

반환 :
시드

와 함께 사용할 수 있는 연결 ID입니다 FigureCanvasBase.mpl_disconnect.

예

def on_press(event):
    print('you pressed', event.button, event.xdata, event.ydata)

cid = canvas.mpl_connect('button_press_event', on_press)
mpl_disconnect ( cid ) [출처] #

ID가 cid 인 콜백을 연결 해제하십시오 .

예

cid = canvas.mpl_connect('button_press_event', on_press)
# ... later
canvas.mpl_disconnect(cid)
classmethod new_manager ( 그림 , 숫자 ) [출처] #

이 캔버스 클래스를 사용하여 그림 에 대한 새 그림 관리자를 만듭니다 .

메모

이 메서드는 하위 클래스에서 다시 구현하면 안 됩니다. 커스텀 매니저 생성 로직이 필요한 경우 다시 구현해주세요 FigureManager.create_with_canvas.

new_timer ( 간격 = 없음 , 콜백 = 없음 ) [소스] #

의 새 백엔드별 하위 클래스를 만듭니다 Timer.

이는 백엔드의 기본 이벤트 루프를 통해 주기적인 이벤트를 가져오는 데 유용합니다. GUI가 있는 백엔드에만 구현됩니다.

매개변수 :
간격 정수

밀리초 단위의 타이머 간격입니다.

콜백 목록[tuple[callable, tuple, dict]]

(func, args, kwargs) 시퀀스는 간격 마다 타이머에 의해 실행됩니다 .func(*args, **kwargs)

타이머에서 반환 False되거나 0제거될 콜백.

예

>>> timer = fig.canvas.new_timer(callbacks=[(f1, (1,), {'a': 3})])
선택 ( 마우스 이벤트 ) [소스] #

[ 더 이상 사용되지 않음 ]

메모

버전 3.6부터 사용되지 않음: 대신 canvas.figure.pick을 사용하세요.

pick_event ( mouseevent , 아티스트 , ** kwargs ) [출처] #

[ Deprecated ] 선택 이벤트에 대한 콜백 처리.

이 메소드는 선택된 아티스트에 의해 호출되며 PickEvent콜백 등록된 리스너를 발생시킵니다.

아티스트는 기본적으로 선택할 수 없습니다( 참조 Artist.set_picker).

메모

버전 3.6부터 폐지됨: 대신 callbacks.process('pick_event', PickEvent(...)) 를 사용하십시오.

print_figure ( 파일 이름 , dpi = 없음 , facecolor = 없음 , edgecolor = 없음 , 방향 = '세로' , 형식 = 없음 , * , bbox_inches = 없음 , pad_inches = 없음 , bbox_extra_artists = 없음 , 백엔드 = 없음 , ** kwargs ) [출처 ] #

그림을 하드카피로 렌더링합니다. 그림 패치 면과 가장자리 색상을 설정합니다. 이것은 일부 GUI가 회색 그림 면 색상 배경을 가지고 있기 때문에 유용하며 하드카피에서 이를 무시하고 싶을 것입니다.

매개변수 :
filename str 또는 경로 유사 또는 파일 유사

Figure가 저장되는 파일입니다.

dpi float, 기본값: rcParams["savefig.dpi"](기본값: 'figure')

그림을 저장할 인치당 도트 수입니다.

facecolor 색상 또는 '자동', 기본값: rcParams["savefig.facecolor"](기본값: 'auto')

인물의 얼굴색. '자동'인 경우 현재 그림 면색을 사용합니다.

edgecolor 색상 또는 '자동', 기본값: rcParams["savefig.edgecolor"](기본값: 'auto')

그림의 가장자리 색상입니다. '자동'인 경우 현재 그림 edgecolor를 사용합니다.

오리엔테이션 {'가로', '세로'}, 기본값: '세로'

현재 PostScript 인쇄에만 적용됩니다.

형식 str, 선택사항

특정 파일 형식을 강제합니다. 지정하지 않으면 파일 이름 확장자 에서 형식을 유추 하고 실패하면 rcParams["savefig.format"](기본값: 'png')에서 유추합니다.

bbox_inches 'tight' 또는 Bbox, 기본값: rcParams["savefig.bbox"](기본값: None)

경계 상자(인치): 그림의 지정된 부분만 저장됩니다. '빡빡한' 경우 그림의 단단한 bbox를 알아내십시오.

pad_inches float, 기본값: rcParams["savefig.pad_inches"](기본값: 0.1)

bbox_inches 가 '빡빡' 할 때 그림 주위의 패딩 양입니다 .

bbox_extra_artists 목록 Artist, 선택 사항

타이트한 bbox를 계산할 때 고려할 추가 아티스트 목록입니다.

백엔드 str, 선택사항

예를 들어 기본 "agg"가 아닌 "cairo" 백엔드가 있는 png 파일을 렌더링하거나 기본 "pdf"가 아닌 "pgf" 백엔드가 있는 pdf 파일을 렌더링하려면 기본이 아닌 백엔드를 사용하십시오. 일반적으로 기본 백엔드로 충분합니다. 각 파일 형식에 대한 유효한 백엔드 목록은 내장 백엔드 를 참조하십시오 . 사용자 지정 백엔드는 "module://..."로 참조할 수 있습니다.

release_mouse ( ax ) [출처] #

도끼 로 쥐고 있던 쥐를 놓으십시오 .Axes

일반적으로 위젯에 의해 호출됩니다. ax 가 현재 마우스 그랩을 가지고 있지 않더라도 이것을 호출하는 것은 괜찮습니다 .

required_interactive_framework = 없음 #
크기 조정 ( w , h ) [출처] #

미사용: 캔버스 크기를 픽셀 단위로 설정합니다.

특정 백엔드는 유사한 방법을 내부적으로 구현할 수 있지만 Matplotlib 자체의 요구 사항이 아니며 사용되지도 않습니다.

resize_event ( ) [출처] #

[ 비추천 ] ResizeEvent에 연결된 모든 함수에 a를 전달합니다 resize_event.

메모

버전 3.6부터 폐지: 대신 callbacks.process('resize_event', ResizeEvent(...)) 를 사용하세요.

scroll_event ( x , y , 단계 , guiEvent = 없음 ) [소스] #

[ Deprecated ] 스크롤 이벤트에 대한 콜백 처리.

백엔드 파생 클래스는 스크롤 휠 이벤트에서 이 함수를 호출해야 합니다. ( x , y )는 캔버스 좌표입니다((0, 0)은 왼쪽 아래에 있음). 버튼과 키는 에 정의된 대로입니다 MouseEvent.

이 메서드는 인스턴스와 함께 'scroll_event'에 연결된 모든 함수를 호출합니다 MouseEvent.

메모

버전 3.6부터 폐지: callbacks.process('scroll_event', MouseEvent(...)) 를 대신 사용하세요.

속성 scroll_pick_id #
set_cursor ( 커서 ) [소스] #

현재 커서를 설정합니다.

백엔드에 아무 것도 표시되지 않으면 효과가 없을 수 있습니다.

백엔드에서 요구하는 경우 이 메소드는 커서가 설정된 후 백엔드 이벤트 루프에서 업데이트를 트리거해야 합니다. 이 메소드는 예를 들어 GUI가 업데이트되지 않는 장기 실행 작업 전에 호출될 수 있기 때문입니다.

매개변수 :
커서Cursors

캔버스 위에 표시할 커서입니다. 참고: 일부 백엔드는 전체 창의 커서를 변경할 수 있습니다.

start_event_loop ( 시간 초과 = 0 ) [소스] #

차단 이벤트 루프를 시작합니다.

ginput이러한 이벤트 루프는 및 와 같은 대화형 함수에서 waitforbuttonpress이벤트를 대기하는 데 사용됩니다.

stop_event_loop콜백 함수가 트리거 하거나 시간 초과 에 도달 할 때까지 이벤트 루프가 차단 됩니다.

timeout 이 0이거나 음수이면 절대 시간 초과되지 않습니다 .

대화형 백엔드만 이 방법을 다시 구현해야 하며 flush_events적절하게 구현되어야 합니다.

대화형 백엔드는 이를 보다 자연스러운 방식으로 구현해야 합니다.

stop_event_loop ( ) [출처] #

현재 차단 이벤트 루프를 중지합니다.

대화형 백엔드는 일치하도록 이를 다시 구현해야 합니다. start_event_loop

support_blit = 거짓 #
switch_backends ( FigureCanvasClass ) [출처] #

FigureCanvasClass의 인스턴스를 인스턴스화합니다.

예를 들어 FigureCanvasGTK에서 FigureCanvasPS를 인스턴스화하기 위해 백엔드 전환에 사용됩니다. 깊은 복사가 수행되지 않으므로 인스턴스 중 하나에 대한 모든 변경 사항(예: 그림 크기 또는 선 소품 설정)은 다른 인스턴스에 반영됩니다.

클래스 matplotlib.backend_bases. FigureManagerBase ( 캔버스 , 숫자 ) [소스] #

베이스:object

Figure 컨테이너 및 컨트롤러의 백엔드 독립적인 추상화입니다.

그림 관리자는 pyplot에서 백엔드 독립적인 방식으로 창과 상호 작용하는 데 사용됩니다. 화면에 시각적 형상을 표현하는 실제(GUI) 프레임워크용 어댑터입니다.

GUI 백엔드는 이 클래스에서 정의하여 표시 또는 크기 조정 과 같은 일반적인 작업 을 GUI 관련 코드로 변환합니다. 비 GUI 백엔드는 이러한 작업을 지원하지 않으며 기본 클래스만 사용할 수 있습니다.

다음과 같은 기본 작업에 액세스할 수 있습니다.

윈도우 작업

키 및 마우스 버튼 누르기 처리

key_press_handler그림 관리자는 matplotlib 이벤트 시스템 에 연결하여 기본 키 및 마우스 버튼 누름 처리를 설정합니다 . 이렇게 하면 백엔드 간에 동일한 바로 가기와 마우스 동작이 보장됩니다.

기타 작업

하위 클래스에는 추가 기능에 액세스하기 위한 추가 특성과 기능이 있습니다. 이것은 물론 백엔드에 따라 다릅니다. 예를 들어, 대부분의 GUI 백엔드는 각 프레임워크의 기본 GUI 위젯에 대한 액세스를 제공하는 속성을 window가지고 있습니다.toolbar

속성 :
캔버스FigureCanvasBase

백엔드별 캔버스 인스턴스.

숫자 int 또는 str

그림 번호입니다.

key_press_handler_id 정수

도구 관리자를 사용할 때 기본 키 처리기 cid입니다. 기본 키 누름 처리를 비활성화하려면 다음을 사용하십시오.

figure.canvas.mpl_disconnect(
    figure.canvas.manager.key_press_handler_id)
button_press_handler_id 정수

도구 관리자를 사용할 때 기본 마우스 버튼 처리기 cid입니다. 기본 버튼 누르기 처리를 비활성화하려면 다음을 사용하십시오.

figure.canvas.mpl_disconnect(
    figure.canvas.manager.button_press_handler_id)
classmethod create_with_canvas ( canvas_class , figure , num ) [소스] #

특정 canvas_class 를 사용하여 주어진 그림 에 대한 관리자를 만듭니다 .

백엔드는 캔버스 또는 관리자 설정에 대한 특정 요구 사항이 있는 경우 이 메서드를 재정의해야 합니다.

파괴 ( ) [출처] #
full_screen_toggle ( ) [출처] #
get_window_title ( ) [출처] #

그림을 포함하는 창의 제목 텍스트를 반환하거나, 창이 없으면 None을 반환합니다(예: PS 백엔드).

크기 조정 ( w , h ) [출처] #

GUI 백엔드의 경우 창 크기를 조정합니다(물리적 픽셀 단위).

set_window_title ( 제목 ) [출처] #

그림이 포함된 창의 제목 텍스트를 설정합니다.

비GUI(예: PS) 백엔드에는 영향을 미치지 않습니다.

쇼 ( ) [출처] #

GUI 백엔드의 경우 Figure 창을 표시하고 다시 그립니다. GUI가 아닌 백엔드의 경우 헤드리스로 실행되지 않는 한(예: DISPLAY가 설정되지 않은 Linux에서) 예외를 발생시킵니다. 이 예외는 에서 경고로 변환됩니다 Figure.show.

클래스 matplotlib.backend_bases. GraphicsContextBase [소스] #

베이스:object

색상, 선 스타일 등을 제공하는 추상 기본 클래스입니다.

copy_properties ( gc ) [소스] #

gc 에서 self로 속성을 복사합니다 .

get_alpha ( ) [출처] #

블렌딩에 사용되는 알파 값을 반환합니다. 모든 백엔드에서 지원되지는 않습니다.

get_antialiased ( ) [출처] #

객체가 앤티앨리어싱된 렌더링을 시도해야 하는지 여부를 반환합니다.

get_capstyle ( ) [출처] #

를 반환합니다 CapStyle.

get_clip_path ( ) [소스] #

(path, transform) 형식으로 클립 경로를 반환합니다. 여기서 path는 Path인스턴스이고 transform은 클리핑 전에 경로에 적용할 아핀 변환입니다.

get_clip_rectangle ( ) [출처] #

클립 사각형을 Bbox인스턴스로 반환합니다.

get_dashes ( ) [출처] #

대시 스타일을 (오프셋, 대시 목록) 쌍으로 반환합니다.

자세한 내용 set_dashes은 참조하십시오.

기본값은 (없음, 없음)입니다.

get_forced_alpha ( ) [출처] #

get_alpha()에 의해 주어진 값이 다른 알파 채널 값을 재정의하는 데 사용되어야 하는지 여부를 반환합니다.

get_gid ( ) [출처] #

하나가 설정되어 있으면 객체 식별자를 반환하고 그렇지 않으면 None을 반환합니다.

get_hatch ( ) [출처] #

현재 해치 스타일을 가져옵니다.

get_hatch_color ( ) [출처] #

해치 색상을 가져옵니다.

get_hatch_linewidth ( ) [출처] #

해치 선폭을 가져옵니다.

get_hatch_path ( 밀도 = 6.0 ) [소스] #

Path현재 해치에 대해 a를 반환합니다 .

get_joinstyle ( ) [출처] #

를 반환합니다 JoinStyle.

get_linewidth ( ) [소스] #

선 너비를 포인트 단위로 반환합니다.

get_rgb ( ) [소스] #

0-1에서 3개 또는 4개의 float로 구성된 튜플을 반환합니다.

get_sketch_params ( ) [출처] #

아티스트의 스케치 매개변수를 반환합니다.

반환 :
튜플 또는None

다음 요소가 포함된 3-튜플:

  • scale: 소스 라인에 수직인 흔들림의 진폭입니다.

  • length: 선을 따라 흔들거리는 길이입니다.

  • randomness: 길이가 축소되거나 확장되는 축척 비율입니다.

None스케치 매개변수가 설정되지 않은 경우 반환 될 수 있습니다.

get_snap ( ) [소스] #

다음과 같은 스냅 설정을 반환합니다.

  • True: 정점을 가장 가까운 픽셀 중심에 맞춥니다.

  • False: 정점을 그대로 둡니다.

  • 없음: (자동) 경로에 직선 세그먼트만 포함된 경우 가장 가까운 픽셀 중심으로 반올림

get_url ( ) [출처] #

URL이 설정되어 있으면 반환하고 그렇지 않으면 None을 반환합니다.

복원 ( ) [소스] #

스택에서 그래픽 컨텍스트를 복원합니다. 스택에 그래픽 컨텍스트를 저장하는 백엔드에만 필요합니다.

set_alpha ( 알파 ) [소스] #

블렌딩에 사용되는 알파 값을 설정합니다. 모든 백엔드에서 지원되지는 않습니다.

(기본값) 이면 alpha=None전경 및 채우기 색상의 알파 구성 요소가 각각의 투명도를 설정하는 데 사용됩니다(해당되는 경우). 그렇지 않으면 alpha재정의합니다.

set_antialiased ( b ) [소스] #

앤티앨리어싱된 렌더링으로 개체를 그릴지 여부를 설정합니다.

set_capstyle ( cs ) [출처] #

선의 끝점을 그리는 방법을 설정합니다.

매개변수 :
cs CapStyle또는 {'butt', 'projecting', 'round'}
set_clip_path ( 경로 ) [소스] #

클립 경로를 a TransformedPath또는 None으로 설정합니다.

set_clip_rectangle ( 사각형 ) [소스] #

클립 사각형을 a Bbox또는 None으로 설정합니다.

set_dashes ( dash_offset , dash_list ) [소스] #

gc의 대시 스타일을 설정합니다.

매개변수 :
dash_offset 플로트

패턴을 시작할 대시 패턴까지의 거리(포인트). 일반적으로 0으로 설정됩니다.

dash_list 유사 배열 또는 None

포인트로서의 온-오프 시퀀스. 없음은 실선을 지정합니다. 그렇지 않으면 모든 값은 음수가 아니어야 합니다(\(\ge 0\)).

메모

페이지를 참조하십시오. 자세한 내용은 PostScript Language Reference 의 666을 참조 하십시오.

set_foreground ( fg , isRGBA = False ) [소스] #

전경색을 설정합니다.

매개변수 :
fg 색상
isRGBA 부울

fg 가 튜플 로 알려진 경우 성능을 향상시키기 위해 isRGBA 를 True로 설정할 수 있습니다.(r, g, b, a)

set_gid ( id ) [소스] #

아이디를 설정합니다.

set_hatch ( 해치 ) [소스] #

해치 스타일을 설정합니다(채우기용).

set_hatch_color ( 해치_색상 ) [출처] #

해치 색상을 설정합니다.

set_joinstyle ( js ) [소스] #

선분 사이의 연결을 그리는 방법을 설정합니다.

매개변수 :
js JoinStyle또는 {'마이터', '라운드', '베벨'}
set_linewidth ( w ) [소스] #

선폭을 포인트 단위로 설정합니다.

set_sketch_params ( scale = None , length = None , randomness = None ) [출처] #

스케치 매개변수를 설정합니다.

매개변수 :
스케일 플로트, 옵션

소스 라인에 수직인 흔들기의 진폭(픽셀 단위)입니다. 스케일이 None이거나 제공되지 않으면 스케치 필터가 제공되지 않습니다.

길이 float, 기본값: 128

선을 따라 흔들리는 길이(픽셀 단위)입니다.

무작위 부동 소수점, 기본값: 16

길이가 축소되거나 확장되는 축척 비율입니다.

set_snap ( 스냅 ) [소스] #

다음과 같은 스냅 설정을 지정합니다.

  • True: 정점을 가장 가까운 픽셀 중심에 맞춥니다.

  • False: 정점을 그대로 둡니다.

  • 없음: (자동) 경로에 직선 세그먼트만 포함된 경우 가장 가까운 픽셀 중심으로 반올림

set_url ( url ) [출처] #

호환되는 백엔드의 링크에 대한 URL을 설정합니다.

클래스 matplotlib.backend_bases. KeyEvent ( name , canvas , key , x = 0 , y = 0 , guiEvent = None ) [소스] #

베이스:LocationEvent

키 이벤트(키 누르기, 키 떼기).

KeyEvent에는 부모 Event및 LocationEvent클래스에 의해 정의된 속성 외에 여러 특수 속성이 있습니다.

메모

수정자 키는 누른 키 앞에 붙고 "ctrl", "alt", "super" 순서로 지정됩니다. 이 규칙의 예외는 누른 키 자체가 수정자 키이므로 "ctrl+alt" 및 "alt+control"이 모두 유효한 키 값일 수 있는 경우입니다.

예

def on_key(event):
    print('you pressed', event.key, event.xdata, event.ydata)

cid = fig.canvas.mpl_connect('key_press_event', on_key)
속성 :
키 없음 또는 str

키를 눌렀습니다. None , 단일 대소 문자 구분 유니코드 문자("g", "G", "#" 등), 특수 키("control", "shift", "f1", "up" 등) 또는 위의 조합(예: "ctrl+alt+g", "ctrl+alt+G").

클래스 matplotlib.backend_bases. LocationEvent ( 이름 , 캔버스 , x , y , guiEvent = 없음 ) [소스] #

베이스:Event

화면 위치가 있는 이벤트입니다.

LocationEvent에는 상위 Event클래스에서 정의한 속성 외에 여러 가지 특수 속성이 있습니다.

속성 :
x, y 정수 또는 없음

캔버스 왼쪽 하단의 이벤트 위치(픽셀 단위).

inaxes Axes또는 없음

마우스가 있는 Axes인스턴스입니다(있는 경우).

xdata, ydata float 또는 없음

inaxes 내 마우스의 데이터 좌표 또는 마우스가 Axes 위에 있지 않은 경우 None 입니다.

마지막 이벤트 = 없음 #
클래스 matplotlib.backend_bases. MouseButton ( 값 ) [소스] #

베이스:IntEnum

열거형.

뒤로 = 8 [출처] #
앞으로 = 9 [출처] #
왼쪽 = 1 [출처] #
MIDDLE = 2 [출처] #
오른쪽 = 3 [출처] #
클래스 matplotlib.backend_bases. MouseEvent ( name , canvas , x , y , button = None , key = None , step = 0 , dblclick = False , guiEvent = None ) [소스] #

베이스:LocationEvent

마우스 이벤트('button_press_event', 'button_release_event', 'scroll_event', 'motion_notify_event').

MouseEvent에는 부모 Event및 LocationEvent클래스에 의해 정의된 속성 외에도 많은 특수 속성이 있습니다.

예

def on_press(event):
    print('you pressed', event.button, event.xdata, event.ydata)

cid = fig.canvas.mpl_connect('button_press_event', on_press)
속성 :
버튼 없음 or MouseButtonor {'up', 'down'}

버튼을 눌렀습니다. 'up' 및 'down'은 스크롤 이벤트에 사용됩니다.

LEFT 및 RIGHT는 실제로 "기본" 및 "보조" 버튼을 나타냅니다. 즉, 사용자가 왼쪽 및 오른쪽 버튼을 뒤집으면("왼손잡이 설정") LEFT 버튼은 물리적으로 오른쪽에 있는 버튼이 됩니다.

이것이 설정되지 않고 이름 이 "scroll_event"이고 단계 가 0이 아닌 경우 단계 의 부호에 따라 "위로" 또는 "아래로"로 설정됩니다 .

키 없음 또는 str

마우스 이벤트가 트리거될 때 누른 키(예: 'shift'). 참조하십시오 KeyEvent.

경고

이 키는 현재 캔버스 내에서 발생한 마지막 'key_press_event' 또는 'key_release_event'에서 가져옵니다. 따라서 캔버스에 포커스가 없을 때 키보드 상태의 마지막 변경이 발생한 경우 이 속성은 잘못됩니다.

스텝 플로트

스크롤 단계 수('up'은 양수, 'down'은 음수). 이것은 'scroll_event'에만 적용되며 그렇지 않은 경우 기본값은 0입니다.

더블클릭 부울

이벤트가 더블 클릭인지 여부. 이것은 'button_press_event'에만 적용되며 그렇지 않으면 False입니다. 특히 'button_release_event'에서는 사용하지 않는다.

클래스 matplotlib.backend_bases. NavigationToolbar2 ( 캔버스 ) [소스] #

베이스:object

탐색 커서 버전 2의 기본 클래스입니다.

백엔드는 'button_press_event' 및 'button_release_event'에 대한 연결을 처리하는 캔버스를 구현해야 합니다. 자세한 내용은 FigureCanvasBase.mpl_connect()를 참조하십시오.

또한 정의해야 합니다.

save_figure()

현재 그림 저장

draw_rubberband()(선택 과목)

확대/축소를 "고무줄" 사각형으로 그립니다.

set_message()(선택 과목)

디스플레이 메시지

set_history_buttons()(선택 과목)

기록 뒤로/앞으로 버튼을 변경하여 비활성화/활성화 상태를 나타낼 수 있습니다.

__init__기본 클래스 init를 호출하는 것을 잊지 않고 도구 모음을 설정하도록 재정의 합니다. 일반적으로 , , , , 및 메서드 __init__에 연결된 도구 모음 버튼을 설정 하고 데이터 경로의 "images" 하위 디렉토리에 있는 표준 아이콘을 사용해야 합니다.homebackforwardpanzoomsave_figure

그게 다야, 나머지는 우리가 할거야!

뒤로 ( * 인수 ) [출처] #

뷰 림 스택 위로 다시 이동합니다.

종종 추가 매개변수가 전달되는 GUI 콜백으로 직접 연결되는 편의를 위해 이 메서드는 임의의 매개변수를 허용하지만 사용하지는 않습니다.

configure_subplots ( * 인수 ) [소스] #
drag_pan ( 이벤트 ) [소스] #

팬/줌 모드에서 끌기 위한 콜백.

drag_zoom ( 이벤트 ) [소스] #

확대/축소 모드에서 드래그하기 위한 콜백입니다.

draw_rubberband ( 이벤트 , x0 , y0 , x1 , y1 ) [소스] #

확대/축소 제한을 나타내기 위해 직사각형 고무줄을 그립니다.

및 가 보장되지 않습니다 .x0 <= x1y0 <= y1

앞으로 ( * 인수 ) [소스] #

뷰 림 스택에서 앞으로 이동합니다.

종종 추가 매개변수가 전달되는 GUI 콜백으로 직접 연결되는 편의를 위해 이 메서드는 임의의 매개변수를 허용하지만 사용하지는 않습니다.

홈 ( * 인수 ) [소스] #

원래 보기를 복원합니다.

종종 추가 매개변수가 전달되는 GUI 콜백으로 직접 연결되는 편의를 위해 이 메서드는 임의의 매개변수를 허용하지만 사용하지는 않습니다.

mouse_move ( 이벤트 ) [소스] #
pan ( * 인수 ) [소스] #

팬/줌 도구를 전환합니다.

왼쪽 버튼으로 팬, 오른쪽으로 줌.

press_pan ( 이벤트 ) [소스] #

팬/줌 모드에서 마우스 버튼 누름에 대한 콜백입니다.

press_zoom ( 이벤트 ) [소스] #

rect 모드로 확대/축소할 때 마우스 버튼 누름에 대한 콜백입니다.

push_current ( ) [소스] #

현재 보기 제한과 위치를 스택에 푸시합니다.

release_pan ( 이벤트 ) [소스] #

팬/줌 모드에서 마우스 버튼 해제에 대한 콜백입니다.

release_zoom ( 이벤트 ) [소스] #

확대/축소 모드에서 마우스 버튼 해제에 대한 콜백입니다.

remove_rubberband ( ) [출처] #

고무줄을 제거합니다.

save_figure ( * 인수 ) [소스] #

현재 그림을 저장합니다.

set_cursor ( 커서 ) [소스] #

[ Deprecated ] 현재 커서를 Cursors열거형 값 중 하나로 설정합니다.

백엔드에서 요구하는 경우 이 메소드는 커서가 설정된 후 백엔드 이벤트 루프에서 업데이트를 트리거해야 합니다. 이 메소드는 예를 들어 GUI가 업데이트되지 않는 장기 실행 작업 전에 호출될 수 있기 때문입니다.

메모

버전 3.5부터 사용되지 않음: 대신 사용하십시오 FigureCanvasBase.set_cursor.

set_history_buttons ( ) [출처] #

뒤로/앞으로 버튼을 활성화 또는 비활성화합니다.

set_message ( s ) [소스] #

도구 모음이나 상태 표시줄에 메시지를 표시합니다.

toolitems = (('홈', ' 원래 보기 재설정 ', '홈', '홈'), ('뒤로', ' 이전 보기로 돌아가기', ' 뒤로', '뒤로'), ('앞으로', ' 다음 보기 로 앞으로 ', '앞으로', '앞으로'), (없음, 없음, 없음, 없음), ('팬', '왼쪽 버튼 팬, 오른쪽 버튼 확대/축소\nx/y 축 고정 , CTRL 로 화면비 고정' , '이동', '이동'),('확대/축소', ' 사각형 으로 확대/축소 \nx/y 고정 축', 'zoom_to_rect', 'zoom'), ('Subplots', 'Configure subplots' , 'subplots' , 'configure_subplots'), (없음, 없음, 없음, 없음), ('저장', ' 저장 그림', 'filesave', 'save_figure')) #
업데이트 ( ) [출처] #

축 스택을 재설정합니다.

줌 ( * 인수 ) [소스] #
예외 matplotlib.backend_bases. NonGuiException [소스] #

베이스:Exception

비 GUI 백엔드에서 그림을 표시하려고 할 때 발생합니다.

클래스 matplotlib.backend_bases. PickEvent ( name , canvas , mouseevent , artist , guiEvent = None , ** kwargs ) [출처] #

베이스:Event

픽 이벤트.

이 이벤트는 사용자가 로 선택할 수 있는 아티스트와 충분히 가까운 캔버스의 위치를 ​​선택하면 시작됩니다 Artist.set_picker.

PickEvent에는 상위 Event클래스에서 정의한 속성 외에 여러 특수 속성이 있습니다.

예

on_pick()선택한 데이터 포인트의 좌표를 인쇄하는 함수를 선택 이벤트에 바인딩합니다 .

ax.plot(np.rand(100), 'o', picker=5)  # 5 points tolerance

def on_pick(event):
    line = event.artist
    xdata, ydata = line.get_data()
    ind = event.ind
    print('on pick line:', np.array([xdata[ind], ydata[ind]]).T)

cid = fig.canvas.mpl_connect('pick_event', on_pick)
속성 :
마우스 이벤트MouseEvent

선택을 생성한 마우스 이벤트입니다.

아티스트matplotlib.artist.Artist

뽑힌 아티스트. 아티스트는 기본적으로 선택할 수 없습니다( 참조 Artist.set_picker).

다른

선택한 객체의 유형에 따라 추가 속성이 있을 수 있습니다. 예를 들어 Line2D픽은 픽과 다른 추가 속성을 정의할 수 있습니다 PatchCollection.

클래스 matplotlib.backend_bases. 렌더러베이스 [소스] #

베이스:object

그리기/렌더링 작업을 처리하는 추상 기본 클래스입니다.

전체 기능을 위해 다음 메서드를 백엔드에서 구현해야 합니다(단지 구현하는 draw_path것만으로도 뛰어난 백엔드를 제공할 수 있음).

최적화를 위해 백엔드에서 다음 메서드 를 구현 해야 합니다.

close_group ( s ) [출처] #

레이블이 s 인 그룹화 요소를 닫습니다 .

SVG 렌더러에서만 사용됩니다.

draw_gouraud_triangle ( gc , 포인트 , 색상 , 변환 ) [소스] #

Gouraud 음영 삼각형을 그립니다.

매개변수 :
gcGraphicsContextBase

그래픽 컨텍스트입니다.

포인트 (3, 2) 배열형

삼각형의 (x, y) 점 배열입니다.

색상 (3, 4) 배열형

삼각형의 각 점에 대한 RGBA 색상입니다.

변환matplotlib.transforms.Transform

점에 적용할 아핀 변환입니다.

draw_gouraud_triangles ( gc , triangles_array , colors_array , transform ) [출처] #

일련의 Gouraud 삼각형을 그립니다.

매개변수 :
포인트 (N, 3, 2) 배열형

삼각형에 대한 N (x, y) 포인트 의 배열입니다 .

색상 (N, 3, 4) 배열형

삼각형의 각 점에 대한 N RGBA 색상 의 배열입니다 .

변환matplotlib.transforms.Transform

점에 적용할 아핀 변환입니다.

draw_image ( gc , x , y , im , 변환 = 없음 ) [소스] #

RGBA 이미지를 그립니다.

매개변수 :
gcGraphicsContextBase

클리핑 정보가 있는 그래픽 컨텍스트입니다.

x 스칼라

캔버스 왼쪽에서 물리적 단위(즉, 점 또는 픽셀)로 표시되는 거리입니다.

y 스칼라

캔버스 아래쪽에서 물리적 단위(즉, 점 또는 픽셀)로 표시되는 거리입니다.

im (N, M, 4) np.uint8의 배열과 유사

RGBA 픽셀의 배열입니다.

변환matplotlib.transforms.Affine2DBase

option_scale_image구체적인 백엔드가 를 반환 하도록 작성된 경우에만 True아핀 변환(즉, Affine2DBase) 이 에 전달될 수 있습니다 draw_image. 변환의 변환 벡터는 물리적 단위(즉, 도트 또는 픽셀)로 제공됩니다. 변환은 x 및 y 를 재정의하지 않으며 결과를 x 및 y 로 변환 하기 전에 적용 해야 합니다(이는 변환 에 의해 정의된 변환 벡터에 x 및 y 를 추가하여 수행할 수 있음 ).

draw_markers ( gc , marker_path , marker_trans , path , trans , rgbFace = None ) [소스] #

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

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

매개변수 :
gcGraphicsContextBase

그래픽 컨텍스트입니다.

marker_transmatplotlib.transforms.Transform

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

트랜스matplotlib.transforms.Transform

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

draw_path ( gc , 경로 , 변환 , rgbFace = 없음 ) [소스] #

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

draw_path_collection ( gc , master_transform , paths , all_transforms , offsets , offset_trans , facecolors , edgecolors , linewidths , linestyles , antialiaseds , urls , offset_position ) [소스] #

경로 모음을 그 립니다.

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

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

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

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

draw_quad_mesh ( gc , master_transform , meshWidth , meshHeight , coordinates , offsets , offsetTrans , facecolors , antialiased , edgecolors ) [소스] #

쿼드 메쉬를 그립니다.

기본(폴백) 구현은 쿼드 메시를 경로로 변환한 다음 draw_path_collection.

draw_tex ( gc , x , y , s , prop , angle , * , mtext = None ) [출처] #
draw_text ( gc , x , y , s , prop , angle , ismath = False , mtext = None ) [출처] #

텍스트 인스턴스를 그립니다.

매개변수 :
gcGraphicsContextBase

그래픽 컨텍스트입니다.

x 플로트

디스플레이 좌표에서 텍스트의 x 위치입니다.

y 플로트

디스플레이 좌표에서 텍스트 기준선의 y 위치입니다.

s str

텍스트 문자열입니다.

소품matplotlib.font_manager.FontProperties

글꼴 속성입니다.

앵글 플로트

시계 반대 방향의 회전 각도입니다.

여러 줄 문자matplotlib.text.Text

렌더링할 원본 텍스트 개체입니다.

메모

백엔드 구현자를 위한 참고 사항:

바운딩 박스가 올바른지 확인하려고 할 때(텍스트 레이아웃/정렬이 제대로 작동하도록 하는 것) text.py에서 줄을 변경하는 데 도움이 됩니다.

if 0: bbox_artist(self, renderer)

1이면 실제 경계 상자가 텍스트와 함께 그려집니다.

flipy ( ) [출처] #

y 값이 위에서 아래로 증가하는지 여부를 반환합니다.

이는 텍스트 그리기에만 영향을 미칩니다.

get_canvas_width_height ( ) [출처] #

디스플레이 좌표에서 캔버스 너비와 높이를 반환합니다.

get_image_magnification ( ) [출처] #

에 전달된 이미지를 확대할 배율을 가져옵니다 draw_image. 백엔드에서 다른 아티스트와 다른 해상도의 이미지를 가질 수 있습니다.

get_texmanager ( ) [출처] #

TexManager인스턴스를 반환합니다 .

get_text_width_height_descent ( s , prop , ismath ) [출처] #

디스플레이 좌표 에서 prop 을 사용하여 문자열 s 의 너비, 높이 및 하강(하단에서 기준선까지의 오프셋)을 가져옵니다 .FontProperties

new_gc ( ) [출처] #

의 인스턴스를 반환합니다 GraphicsContextBase.

open_group ( s , gid = 없음 ) [소스] #

레이블 s 및 gid (설정된 경우)를 id로 사용하여 그룹화 요소를 엽니다.

SVG 렌더러에서만 사용됩니다.

option_image_nocomposite ( ) [출처] #

Matplotlib에 의한 이미지 구성을 건너뛸지 여부를 반환합니다.

래스터 백엔드는 일반적으로 False를 반환해야 합니다(C 수준 래스터라이저가 이미지 구성을 처리하도록 함). 벡터 백엔드는 일반적으로 .not rcParams["image.composite_image"]

option_scale_image ( ) [출처] #

임의의 아핀 변환 draw_image이 지원되는지 여부를 반환합니다(대부분의 벡터 백엔드에 대해 True).

points_to_pixels ( 포인트 ) [출처] #

포인트를 표시 단위로 변환합니다.

이 기능을 재정의해야 합니다(백엔드에 포스트스크립트 또는 svg와 같은 dpi가 없는 경우 제외). 일부 이미징 시스템은 인치당 픽셀 값을 가정합니다.

points to pixels = points * pixels_per_inch/72 * dpi/72
매개변수 :
포인트 부동 또는 배열 유사

float 또는 float의 numpy 배열

반환 :
픽셀로 변환된 포인트
start_filter ( ) [소스] #

이미지 필터링 효과를 위해 임시 렌더러로 전환합니다.

현재 agg 렌더러에서만 지원됩니다.

start_rasterizing ( ) [출처] #

래스터 렌더러로 전환합니다.

에서 사용합니다 MixedModeRenderer.

stop_filter ( filter_func ) [출처] #

원래 렌더러로 다시 전환합니다. 임시 렌더러의 내용은 filter_func 로 처리 되고 원본 렌더러에 이미지로 그려집니다.

현재 agg 렌더러에서만 지원됩니다.

stop_rasterizing ( ) [출처] #

벡터 렌더러로 다시 전환하고 래스터 렌더러의 내용을 벡터 렌더러의 이미지로 그립니다.

에서 사용합니다 MixedModeRenderer.

클래스 matplotlib.backend_bases. ResizeEvent ( 이름 , 캔버스 ) [소스] #

베이스:Event

캔버스 크기 조정에 의해 트리거되는 이벤트입니다.

ResizeEvent에는 상위 Event클래스에서 정의한 것 외에도 여러 특수 속성이 있습니다.

속성 :
너비 정수

캔버스의 너비(픽셀)입니다.

높이 정수

캔버스의 높이(픽셀)입니다.

클래스 matplotlib.backend_bases. ShowBase [출처] #

베이스:_Backend

show()백엔드에서 함수 를 생성하는 간단한 기본 클래스 .

mainloop()하위 클래스는 메서드 를 재정의해야 합니다 .

클래스 matplotlib.backend_bases. TimerBase ( 간격 = 없음 , 콜백 = 없음 ) [소스] #

베이스:object

사물 애니메이션에 유용한 타이머 이벤트를 제공하기 위한 기본 클래스입니다. 백엔드는 타이머 이벤트가 이벤트 루프에 통합되도록 자체 타이밍 메커니즘을 사용하기 위해 몇 가지 특정 메서드를 구현해야 합니다.

서브클래스는 다음 메서드를 재정의해야 합니다.

  • _timer_start: 타이머를 시작하기 위한 백엔드별 코드입니다.

  • _timer_stop: 타이머를 중지하기 위한 백엔드별 코드입니다.

하위 클래스는 다음 메서드를 추가로 재정의할 수 있습니다.

  • _timer_set_single_shot: 타이머 개체에서 지원하는 경우 타이머를 싱글 샷 작동 모드로 설정하는 코드입니다. 그렇지 않은 경우 Timer 클래스 자체가 플래그를 저장하고 해당 _on_timer동작을 지원하도록 메서드를 재정의해야 합니다.

  • _timer_set_interval: 타이머 개체에 간격을 설정하는 방법이 있는 경우 타이머에 간격을 설정하는 코드입니다.

  • _on_timer: 타이머 객체가 호출해야 하는 내부 함수로, 설정된 모든 콜백을 실행하는 작업을 처리합니다.

매개변수 :
간격 int, 기본값: 1000ms

타이머 이벤트 사이의 시간(밀리초)입니다. 로 저장됩니다 timer.interval.

콜백 목록[tuple[callable, tuple, dict]]

타이머 이벤트에서 호출될 (func, args, kwargs) 튜플 목록입니다. 이 목록은 접근이 가능 timer.callbacks하고 직접 조작하거나 기능 add_callback을 remove_callback사용할 수 있습니다.

add_callback ( func , * args , ** kwargs ) [소스] #

이벤트 발생 시 타이머에 의해 호출될 func 를 등록 합니다. 제공된 추가 인수는 func 로 전달됩니다 .

이 함수는 func 를 반환하므로 데코레이터로 사용할 수 있습니다.

속성 간격 #

타이머 이벤트 사이의 시간(밀리초)입니다.

remove_callback ( func , * args , ** kwargs ) [소스] #

콜백 목록에서 func 를 제거 합니다.

args 및 kwargs 는 선택 사항이며 다른 인수로 호출되도록 등록된 동일한 함수의 복사본을 구별하는 데 사용됩니다. 이 동작은 더 이상 사용되지 않습니다. 앞으로는 더 이상 고려되지 않습니다. 특정 콜백을 자체적으로 제거 가능하도록 유지하려면 객체 로 전달하십시오.*args, **kwargsadd_callbackfunctools.partial

속성 single_shot #

이 타이머가 단일 실행 후 중지되어야 하는지 여부입니다.

시작 ( 간격 = 없음 ) [소스] #

타이머 개체를 시작합니다.

매개변수 :
간격 정수, 선택사항

타이머 간격(밀리초) 제공된 경우 이전에 설정된 간격을 재정의합니다.

중지 ( ) [출처] #

타이머를 중지합니다.

클래스 matplotlib.backend_bases. ToolContainerBase ( 도구 관리자 ) [소스] #

베이스:object

도구 모음과 같은 모든 도구 컨테이너의 기본 클래스입니다.

속성 :
도구 관리자ToolManager

이 ToolContainer통신하려는 도구입니다.

add_tool ( 도구 , 그룹 , 위치 = -1 ) [소스] #

이 컨테이너에 도구를 추가합니다.

매개변수 :
도구 tool_like

추가할 도구는 을 참조하십시오 ToolManager.get_tool.

그룹 문자열

이 도구를 추가할 그룹의 이름입니다.

위치 int, 기본값: -1

이 도구를 배치할 그룹 내의 위치입니다.

add_toolitem ( 이름 , 그룹 , 위치 , 이미지 , 설명 , 토글 ) [소스] #

컨테이너에 도구 항목을 추가합니다.

이 방법은 백엔드별로 구현해야 합니다.

버튼 클릭 이벤트와 관련된 콜백은 정확히 self.trigger_tool(name) .

매개변수 :
이름 문자열

추가할 도구의 이름으로, 도구의 ID와 버튼의 기본 레이블로 사용됩니다.

그룹 문자열

이 도구가 속한 그룹의 이름입니다.

위치 정수

그룹 내 도구의 위치, -1인 경우 끝에 갑니다.

이미지 문자열

버튼 또는 에 대한 이미지의 파일 이름입니다 None.

설명 문자열

도구 설명에 사용되는 도구 설명입니다.

토글 부울

  • True: 버튼은 토글(연속 클릭 사이에 눌림/눌림 상태 변경)입니다.

  • False: 버튼은 일반 버튼입니다(손을 떼면 누르지 않은 상태로 돌아갑니다).

remove_toolitem ( 이름 ) [소스] #

에서 도구 항목을 제거합니다 ToolContainer.

이 방법은 백엔드별로 구현되어야 합니다.

ToolManager를 내보낼 때 호출됩니다 tool_removed_event.

매개변수 :
이름 문자열

제거할 도구의 이름입니다.

set_message ( s ) [소스] #

도구 모음에 메시지를 표시합니다.

매개변수 :
s str

메시지 텍스트.

toggle_toolitem ( 이름 , 토글 됨 ) [소스] #

이벤트 발생 없이 도구 항목을 토글합니다.

매개변수 :
이름 문자열

전환할 도구의 ID입니다.

토글 부울

이 도구를 토글로 설정할지 여부입니다.

trigger_tool ( 이름 ) [소스] #

도구를 트리거합니다.

매개변수 :
이름 문자열

컨테이너 내에서 트리거된 도구의 이름(id)입니다.

matplotlib.backend_bases. button_press_handler ( 이벤트 , 캔버스 = 없음 , 툴바 = 없음 ) [소스] #

추가 마우스 버튼에 대한 기본 Matplotlib 버튼 동작입니다.

매개변수는 이벤트 가 이라는 key_press_handler점을 제외하고 는 와 같습니다 .MouseEvent

matplotlib.backend_bases. get_registered_canvas_class ( 형식 ) [소스] #

주어진 파일 형식에 대해 등록된 기본 캔버스를 반환합니다. 필요한 백엔드의 지연된 가져오기를 처리합니다.

matplotlib.backend_bases. key_press_handler ( 이벤트 , 캔버스 = 없음 , 툴바 = 없음 ) [소스] #

탐색 키보드 단축키 에 설명된 캔버스 및 도구 모음에 대한 기본 Matplotlib 키 바인딩을 구현합니다 .

매개변수 :
이벤트KeyEvent

키 누름/해제 이벤트.

캔버스 FigureCanvasBase, 기본값:event.canvas

백엔드별 캔버스 인스턴스. 이 매개변수는 이전 버전과의 호환성을 위해 유지되지만 설정된 경우 항상 과 같아야 합니다 event.canvas.

툴바 NavigationToolbar2, 기본값:event.canvas.toolbar

탐색 커서 도구 모음. 이 매개변수는 이전 버전과의 호환성을 위해 유지되지만 설정된 경우 항상 과 같아야 합니다 event.canvas.toolbar.

matplotlib.backend_bases. register_backend ( 형식 , 백엔드 , 설명 = 없음 ) [소스] #

지정된 파일 형식으로 저장하기 위한 백엔드를 등록합니다.

매개변수 :
형식 문자열

파일 확장자

백엔드 모듈 문자열 또는 캔버스 클래스

파일 출력 처리를 위한 백엔드

설명 문자열, 기본값: ""

파일 유형에 대한 설명입니다.