1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML3.2 EN">
<HTML>
<HEAD> <link rel="canonical" href="http://www.mcs.anl.gov/petsc/petsc-current/docs/manualpages/Draw/PetscDrawOpenX.html" />
<META NAME="GENERATOR" CONTENT="DOCTEXT">
<TITLE>PetscDrawOpenX</TITLE>
</HEAD>
<BODY BGCOLOR="FFFFFF">
<div id="version" align=right><b>petsc-3.7.5 2017-01-01</b></div>
<div id="bugreport" align=right><a href="mailto:petsc-maint@mcs.anl.gov?subject=Typo or Error in Documentation &body=Please describe the typo or error in the documentation: petsc-3.7.5 v3.7.5 docs/manualpages/Draw/PetscDrawOpenX.html "><small>Report Typos and Errors</small></a></div>
<A NAME="PetscDrawOpenX"><H1>PetscDrawOpenX</H1></A>
Opens an X-window for use with the <A HREF="../Draw/PetscDraw.html#PetscDraw">PetscDraw</A> routines.
<H3><FONT COLOR="#CC3333">Synopsis</FONT></H3>
<PRE>
#include "petscsys.h"
PetscErrorCode PetscDrawOpenX(MPI_Comm comm,const char display[],const char title[],int x,int y,int w,int h,PetscDraw *draw)
</PRE>
Collective on <A HREF="../Sys/MPI_Comm.html#MPI_Comm">MPI_Comm</A>
<P>
<H3><FONT COLOR="#CC3333">Input Parameters</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>comm </B></TD><TD>- the communicator that will share X-window
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>display </B></TD><TD>- the X display on which to open,or null for the local machine
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>title </B></TD><TD>- the title to put in the title bar,or null for no title
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>x,y </B></TD><TD>- the screen coordinates of the upper left corner of window
may use <A HREF="../Sys/PETSC_DECIDE.html#PETSC_DECIDE">PETSC_DECIDE</A> for these two arguments, then PETSc places the
window
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>w, h </B></TD><TD>- the screen width and height in pixels, or PETSC_DRAW_HALF_SIZE, PETSC_DRAW_FULL_SIZE,
or PETSC_DRAW_THIRD_SIZE or PETSC_DRAW_QUARTER_SIZE
</TD></TR></TABLE>
<P>
<H3><FONT COLOR="#CC3333">Output Parameters</FONT></H3>
<DT><B>draw </B> -the drawing context.
<br>
<P>
<H3><FONT COLOR="#CC3333">Options Database Keys</FONT></H3>
<TABLE border="0" cellpadding="0" cellspacing="0">
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-nox </B></TD><TD>- Disables all x-windows output
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-display <name> </B></TD><TD>- Sets name of machine for the X display
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-draw_pause <pause> </B></TD><TD>- Sets time (in seconds) that the
program pauses after <A HREF="../Draw/PetscDrawPause.html#PetscDrawPause">PetscDrawPause</A>() has been called
(0 is default, -1 implies until user input).
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-draw_cmap <name> </B></TD><TD>- Sets the colormap to use.
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-draw_cmap_reverse </B></TD><TD>- Reverses the colormap.
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-draw_cmap_brighten </B></TD><TD>- Brighten (0 < beta < 1) or darken (-1 < beta < 0) the colormap.
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-draw_x_shared_colormap </B></TD><TD>- Causes PETSc to use a shared
colormap. By default PETSc creates a separate color
for its windows, you must put the mouse into the graphics
window to see the correct colors. This options forces
PETSc to use the default colormap which will usually result
in bad contour plots.
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-draw_fast </B></TD><TD>- Does not create colormap for countour plots.
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-draw_double_buffer </B></TD><TD>- Uses double buffering for smooth animation.
</TD></TR>
<TR><TD WIDTH=40></TD><TD ALIGN=LEFT VALIGN=TOP><B>-geometry </B></TD><TD>- Indicates location and size of window.
</TD></TR></TABLE>
<P>
<P>
<H3><FONT COLOR="#CC3333">Note</FONT></H3>
When finished with the drawing context, it should be destroyed
with <A HREF="../Draw/PetscDrawDestroy.html#PetscDrawDestroy">PetscDrawDestroy</A>().
<P>
<H3><FONT COLOR="#CC3333">Note for Fortran Programmers</FONT></H3>
Whenever indicating null character data in a Fortran code,
PETSC_NULL_CHARACTER must be employed; using NULL is not
correct for character data! Thus, PETSC_NULL_CHARACTER can be
used for the display and title input parameters.
<P>
<P>
<H3><FONT COLOR="#CC3333">See Also</FONT></H3>
<A HREF="../Draw/PetscDrawFlush.html#PetscDrawFlush">PetscDrawFlush</A>(), <A HREF="../Draw/PetscDrawDestroy.html#PetscDrawDestroy">PetscDrawDestroy</A>(), <A HREF="../Draw/PetscDrawCreate.html#PetscDrawCreate">PetscDrawCreate</A>(), PetscDrawOpnOpenGL()
<BR><P><B><P><B><FONT COLOR="#CC3333">Level:</FONT></B>beginner
<BR><FONT COLOR="#CC3333">Location:</FONT></B><A HREF="../../../src/sys/classes/draw/impls/x/drawopenx.c.html#PetscDrawOpenX">src/sys/classes/draw/impls/x/drawopenx.c</A>
<BR><A HREF="./index.html">Index of all Draw routines</A>
<BR><A HREF="../../index.html">Table of Contents for all manual pages</A>
<BR><A HREF="../singleindex.html">Index of all manual pages</A>
</BODY></HTML>
|
