1berry/qtbase
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Doc: Fix minor grammar issues in qtgui landing page

Browse Source 
Task-number: QTBUG-100369
Pick-to: 6.3
Change-Id: I89497facbb33c4a47420a1ba0dd61f51ab407a77
Reviewed-by: Topi Reiniö <topi.reinio@qt.io>
This commit is contained in:
Andreas Eliasson 2022-02-09 06:18:35 +01:00
parent 5cd8d217b4
commit 29229f34b2
1 changed files with 15 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

31
src/gui/doc/src/qtgui.qdoc
View File

@ -44,13 +44,13 @@
The Qt GUI module provides classes for windowing system
integration, event handling, OpenGL and OpenGL ES integration, 2D
graphics, basic imaging, fonts and text. These classes are used
graphics, basic imaging, fonts, and text. These classes are used
internally by Qt's user interface technologies and can also be
used directly, for instance to write applications using low-level
OpenGL ES graphics APIs.
For application developers writing user interfaces, Qt provides
higher level API's, like Qt Quick, that are much more suitable
higher level APIs, like Qt Quick, that are much more suitable
than the enablers found in the Qt GUI module.
\if !defined(qtforpython)
@ -72,7 +72,7 @@
The most important classes in the Qt GUI module are
QGuiApplication and QWindow. A Qt application that wants to show
content on screen, will need to make use of these. QGuiApplication
content on screen will need to make use of these. QGuiApplication
contains the main event loop, where all events from the window
system and other sources are processed and dispatched. It also
handles the application's initialization and finalization.
@ -80,33 +80,32 @@
The \l QWindow class represents a window in the underlying
windowing system. It provides a number of virtual functions to
handle events (\l {QEvent}) from the windowing system, such as
touch-input, exposure, focus, key strokes and geometry changes.
touch-input, exposure, focus, key strokes, and geometry changes.
\section1 2D Graphics
The Qt GUI module contains classes for 2D graphics, imaging, fonts
The Qt GUI module contains classes for 2D graphics, imaging, fonts,
and advanced typography.
A \l QWindow created with the surface type \l
{QSurface::RasterSurface} can be used in combination with \l
{QBackingStore} and \l {QPainter}, Qt's highly optimized 2D vector
graphics API. QPainter supports drawing lines, polygons, vector
paths, images and text. For more information, see \l{Paint
paths, images, and text. For more information, see \l{Paint
System} and \l {Raster Window Example}.
Qt can load and save images using the \l QImage and \l QPixmap
classes. By default, Qt supports the most common image formats
including JPEG and PNG among others. Users can add support for
additional formats via the \l QImageIOPlugin class. For more
information, see \l {Reading and Writing Image Files}
information, see \l {Reading and Writing Image Files}.
Typography in Qt is done with \l QTextDocument which uses the \l
Typography in Qt is done with \l QTextDocument, which uses the \l
QPainter API in combination with Qt's font classes, primarily
QFont. Applications that prefer more low-level APIs to text
and font handling, classes like QRawFont and QGlyphRun can be
used.
QFont. Applications that prefer more low-level APIs to text
and font handling can use classes like QRawFont and QGlyphRun.
\section1 OpenGL and OpenGL ES Integration
@ -122,8 +121,8 @@
OpenGL ES 2 and desktop OpenGL. The convenience classes include
QOpenGLFunctions that lets an application use all the OpenGL ES 2
functions on desktop OpenGL without having to manually resolve the
OpenGL function pointers, thus allowing cross-platform development
of applications targeting mobile or embedded devices, and some
OpenGL function pointers. This enables cross-platform development
of applications targeting mobile or embedded devices, and provides
classes that wrap native OpenGL functionality in a simpler Qt API:
\list
@ -140,18 +139,18 @@
(3.0 and higher) of OpenGL, a versioned function wrapper mechanism
is also available: The QOpenGLFunction_N_N family of classes
expose all the functions in a given OpenGL version and profile,
allowing easy development of desktop applications relying on
allowing easy development of desktop applications that rely on
modern, desktop-only OpenGL features.
For more information, see the \l {OpenGL Window Example}.
The Qt GUI module also contains a few math classes to aid with the
most common mathematical operations related to 3D graphics. These
classes include \l {QMatrix4x4}, \l {QVector4D} and \l {QQuaternion}
classes include \l {QMatrix4x4}, \l {QVector4D}, and \l {QQuaternion}.
A \l {QWindow} created with the \l {QSurface::OpenGLSurface} can
be used in combination with \l QPainter and \l QOpenGLPaintDevice
to have OpenGL hardware accelerated 2D graphics, by sacrificing
to have OpenGL hardware-accelerated 2D graphics by sacrificing
some of the visual quality.